Import

The import command converts agent session transcripts into AgentV’s Message[] format for offline grading — no re-running the agent, no API keys needed.

Supported Providers

Provider	Command	Source
Claude Code	agentv import claude	~/.claude/projects/<path>/<uuid>.jsonl
Codex CLI	agentv import codex	~/.codex/sessions/<YYYY>/<MM>/<DD>/rollout-*.jsonl
Copilot CLI	agentv import copilot	~/.copilot/session-state/<uuid>/events.jsonl

import claude

Import a Claude Code session transcript.

List available sessions

agentv import claude --list

Output:

Found 5 session(s):

  4c4f9e4e-e6f1-490b-a1b1-9aef543ebf22  2m ago  -home-user-myproject
  087b801a-7a63-48ff-b348-62563a290b23  1h ago  -home-user-myproject
  ed8b8c62-4414-49fb-8739-006d809c8588  3h ago  -home-user-other-project

Import a specific session

agentv import claude --session-id 4c4f9e4e-e6f1-490b-a1b1-9aef543ebf22

Filter by project path

agentv import claude --list --project-path /home/user/myproject

Custom output path

agentv import claude --session-id <uuid> -o transcripts/my-session.jsonl

Default output: .agentv/transcripts/claude-<session-id-short>.jsonl

import codex

Import a Codex CLI session transcript.

List available sessions

agentv import codex --list

Import a specific session

agentv import codex --session-id 019d5cff-9f02-7bc3-8f98-2071ba17ef0e

import copilot

Import a Copilot CLI session transcript.

List available sessions

agentv import copilot --list

Import a specific session

agentv import copilot --session-id 9ca6d90c-1d80-40d1-b805-c59ee31fc007

Options

All three providers share the same core flags:

Flag	Description
--session-id <uuid>	Import a specific session by UUID
--list	List available sessions instead of importing
--output, -o <path>	Custom output file path

Provider-specific flags:

Flag	Provider	Description
--project-path <path>	Claude	Filter sessions by project path
--projects-dir <dir>	Claude	Override ~/.claude/projects directory
--date <YYYY-MM-DD>	Codex	Filter sessions by date
--sessions-dir <dir>	Codex	Override ~/.codex/sessions directory
--session-state-dir <dir>	Copilot	Override ~/.copilot/session-state directory

Output Format

The imported transcript is written as JSONL — one Message object per line:

{"role":"user","content":"Fix the bug in auth.ts"}
{"role":"assistant","content":"I'll fix the authentication bug.","toolCalls":[{"tool":"Read","input":{"file_path":"src/auth.ts"},"id":"toolu_01...","output":"...file contents..."}]}

Each message follows AgentV’s standard Message interface with role, content, and optional toolCalls (including tool outputs paired from subsequent events).

What Gets Parsed

Claude Event	AgentV Message
user	{ role: 'user', content }
assistant	{ role: 'assistant', content, toolCalls }
tool_use blocks	ToolCall { tool, input, id }
tool_result blocks	Paired with matching tool_use by ID
progress, system	Skipped
Subagent events	Filtered out (v1)

Token usage is aggregated from the final cumulative value per LLM request. Duration is computed from first-to-last event timestamp.

Workflow

Import a session, then run evaluators against it:

# 1. List sessions and pick one
agentv import claude --list

# 2. Import a session by ID
agentv import claude --session-id 4c4f9e4e-e6f1-490b-a1b1-9aef543ebf22

# 3. Run evaluators against the imported transcript
agentv eval evals/my-eval.yaml --transcript .agentv/transcripts/claude-4c4f9e4e.jsonl

See examples/features/import-claude/ for a complete working example.