docs / cli / supported-agents

Supported Agents

0.3 separates live capture from import support.

Current Support

ModeIdentifierStatusNotes
Live captureclaude-codeSupportedInstalled via opentraces init or opentraces setup claude-code
Dataset importhermesSupportedUsed with opentraces pull --parser hermes

Planned adapters can follow the same contracts without changing the inbox, push, or schema layers.

Live Capture vs Import

Live capture adapters discover and parse session files on disk.

Import adapters read external datasets or files and map them into TraceRecord.

That distinction matters in the public CLI:

opentraces init --agent claude-code
opentraces pull owner/dataset --parser hermes

Adapter Contracts

The capture layer exposes small protocols:

  • SessionParser for live agent session parsing
  • FormatImporter for file or dataset imports
  • HookInstaller for external integrations like Claude Code and git

This is why review, security, and push stay consistent even as new sources are added.

What Gets Normalized

All supported sources are normalized into the same schema with:

  • trace-level metadata
  • steps and reasoning content
  • tool calls and observations when the source provides them
  • outcomes and metrics
  • attribution and git links when available