opencode-to-atif-traces

OpenCode plugin to export Agent Trajectory Interchange Format (ATIF) traces.

Usage

Set the ATIF env var to the output path and run opencode as you normally would:

ATIF=traces.json \
  opencode run "Refactor the XML parser to use a tree structure."

Tracing happens in the background, so you still get the normal stdout / stderr output from opencode in your terminal. This is in contrast with OpenCode's native --format=json, which replaces stdout with the JSON event stream and makes the run much less pleasant to watch interactively.

Status

Work in progress, and not yet battle-tested. The plan is to add tests that mirror the Harbor team's implementation, and to keep the schema in sync as ATIF evolves.

Contributions, issues, and feedback are very welcome. Please open an issue or PR if something is broken or could be better.

Install

Add the package to the plugin array in your opencode.json (see the OpenCode plugin docs):

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-to-atif-traces"]
}

OpenCode installs and caches plugin dependencies automatically on startup.

Acknowledgements

• Event subscription and emission (tool_use, step_start, step_finish, text, reasoning) follows OpenCode's own JSON-format path in packages/opencode/src/cli/cmd/run.ts.
• Per-event ingest that groups events into turns by step_start / step_finish is based on the Harbor team's src/harbor/agents/installed/opencode.py (see commit 6752089).

License

MIT