ironbee import backfills them into the IronBee Collector so your analytics include history, not just sessions from today forward. Discovery scans all three stores (~/.claude/projects/, ~/.codex/sessions/, and Cursor’s local state.vscdb) and routes each session through the right importer automatically, with no client flag needed.
Sessions already tracked are skipped automatically, so the command is safe to re-run.
Basic usage
From a project directory, import that project’s history:Cursor has no per-session transcript file — its “transcript” is the composer stored in
state.vscdb. Token and cost figures for imported Cursor sessions come from Cursor’s usage API and require cursor.apiAccess to be on (the default); without it, imported Cursor sessions carry structure only.Choosing what to import
Pick at most one scope (the default is the current directory):| Flag | Scope |
|---|---|
| (none) | The current project directory |
--projects <p1,p2,...> | Specific projects by absolute path, comma-separated |
--all-projects | Every project Claude Code, Codex, or Cursor has tracked on this machine |
--transcript <path> | A single .jsonl transcript file (Claude Code / Codex) |
Limiting the time range
Pick at most one (the default is no time filter):| Flag | Range |
|---|---|
--since <duration> | Relative window — 30d, 2w, 6m, 12h |
--from <date> [--to <date>] | Explicit window; --to defaults to now |
Preview and safety
| Flag | Description |
|---|---|
--dry-run | Print a cost/event summary and exit without sending anything |
--yes | Skip the confirmation prompt (for scripts/CI) |
--force | Re-import sessions that are already tracked |
--concurrency <N> | Parallel sessions to process (default 4, range 1–32) |
Common scenarios
| Goal | Command |
|---|---|
| Onboard the current project, last 30 days | ironbee import --since 30d |
| Full history for the current project | ironbee import |
| Everything on this machine, last 6 months | ironbee import --all-projects --since 6m |
| A quarter across all projects | ironbee import --all-projects --from 2026-01-01 --to 2026-03-31 |
| Preview before committing | ironbee import --since 30d --dry-run |
| Scripted, no prompt | ironbee import --since 60d --yes |
What’s next?
Inspecting sessions
Check verdicts and session state from the terminal.
Open the Console
Your imported sessions appear alongside live ones, with the same analytics and timelines.