Import AI session history

Prompt-first procedure: Describe the outcome you want in your agent conversation. The agent should select and load the appropriate AIWG assets, explain material changes, request any needed approval, and report verification evidence. Exact commands and flags appear only in the CLI reference.

First time using AIWG? Begin with Install, Connect, and Verify. This guide assumes AIWG is already installed and connected to this project.

Use the session catalog when you want one privacy-aware timeline across multiple AI providers.

Install the catalog's SQLite runtime once and verify that its native module loads:

Use AIWG to complete this documented outcome: Install the catalog's SQLite runtime once and verify that its native module loads
Have it inspect the current state, explain the plan, ask before material
changes, and report the result with verification evidence.

The installer uses a platform prebuild when one is available. On platforms without a compatible prebuild, `better-sqlite3` falls back to `node-gyp`; that requires Python 3, `make`, and a C/C++ compiler supported by your Node platform. Install those prerequisites and repeat the command if the runtime load check fails. AIWG keeps this native dependency in its user-owned optional feature root rather than adding it to every base installation.

From the project root, preview discovery first:

Use AIWG to complete this documented outcome: From the project root, preview discovery first
Have it inspect the current state, explain the plan, ask before material
changes, and report the result with verification evidence.

Claude, Cursor, and Factory histories are discovered only below workspace-keyed provider roots. Codex keeps sessions in a shared root, so authorize it explicitly:

Use AIWG to complete this documented outcome: Claude, Cursor, and Factory histories are discovered only below workspace-keyed provider roots. Codex keeps sessions in a shared root, so authorize it explicitly
Have it inspect the current state, explain the plan, ask before material
changes, and report the result with verification evidence.

The command reports every provider, including unavailable and manual-export providers, and saves an immutable manifest unless the dry-run option is present. Review it, preview the exact batch, then confirm:

Use AIWG to complete this documented outcome: The command reports every provider, including unavailable and manual-export providers, and saves an immutable manifest unless the dry-run option is present. Review it, preview the exact batch, then confirm
Have it inspect the current state, explain the plan, ask before material
changes, and report the result with verification evidence.

For non-interactive automation, the yes option is equivalent to the confirm option. Imports are resumable and idempotent:

Use AIWG to complete this documented outcome: For non-interactive automation, the yes option is equivalent to the confirm option. Imports are resumable and idempotent
Have it inspect the current state, explain the plan, ask before material
changes, and report the result with verification evidence.

Read commands infer an unambiguous current project, so the normal follow-up is:

Use AIWG to complete this documented outcome: Read commands infer an unambiguous current project, so the normal follow-up is
Have it inspect the current state, explain the plan, ask before material
changes, and report the result with verification evidence.

Both list and timeline report whether coverage is complete, partial, stale, or unknown. Use `the min-coverage option 0.95` when an audit should fail below a threshold. If inference reports multiple workspace candidates, rerun with the exact the workspace option shown in the diagnostic.

The catalog contains normalized AIWG copies. Discovery and import never modify provider histories, and source paths are redacted from public command output. Use the agent-owned sessions operation for the complete command and JSON contracts.

Ask questions about collected history

Use the agent’s capability search and the agent’s stable-asset loader for questions such as “where did we decide this?”, “which tool kept failing?”, or “what changed between provider sessions?”. The skill covers scoped FTS5 queries, pagination, timelines, tool/HITL analytics, citations and coverage gaps.

`session-analyst` and the `session-investigation` flow collect and synthesize bounded evidence. `session-harvest` previews extraction and carries reviewed candidate versions through memory promotion. See the exploration recipes for acquisition, comparison, investigation, maintenance and handoff examples.