agentimport

Overview ¶

Command agentimport converts other coding agents' session logs into the Agent Session Format, and reports what each conversion changed.

agentimport convert -o <store> [-from auto|claudecode|pi|codex|atif|cline|clinesdk|openhands|opencode|hermes] [-strict [-accept code,...]] [-slim] [-force] [-report text|json] <file|dir>...
agentimport report [-from auto|claudecode|pi|codex|atif|cline|clinesdk|openhands|opencode|hermes] [-strict [-accept code,...]] [-slim] [-json] <file|dir>...
agentimport version

convert writes every session a conversion makes, the main session and its subsessions, into the jsonl session store rooted at -o, the layout agentsession and dax read, and prints the report. report converts without writing and prints the findings of every input added together, which is how a corpus is surveyed.

A directory argument is searched for sessions; a file argument is one session. With -from auto, each file's source is told from its name and its first lines, an ATIF document by its schema_version, a Cline or Roo Code task by its files' names in a task directory, an OpenHands conversation by its directory, its base_state.json or an event file, an OpenCode store by its data directory, a file in it, or its database, which is converted whole, a Cline SDK session by its directory or a file in it, converted with its children, a Hermes database by its tables, or the home or profile directory holding it, converted whole; a file that is not a session of any source is skipped when it was found in a directory and an error when named.

Both commands exit 1 when a conversion failed, and with -strict when a report holds a dropped finding, or a gap docs/incompatibilities.md does not list, whose code -accept does not name; 2 on bad usage. A documented gap is a known shape of the session format, not a fact of one transcript.