Conversation manager for AI sessions. Handles the lifecycle of agentic conversations — creating, listing, resuming, and switching between sessions. A core component of the ScorpioX runtime that coordinates session state between the AI provider and the local workspace.
💻 Usage Examples
Start a new conversation
$ scorpiox-conv
conv: new session 2026_05_29_wonderful_kare
provider: claude_code (opus)
workspace: /home/user/my-project
ready.
Resume a previous session
$ scorpiox-conv --list
2026_05_29_wonderful_kare (active, 47 turns)
2026_05_28_elegant_morse (paused, 23 turns)
2026_05_27_relaxed_turing (finished, 112 turns)
$ scorpiox-conv --resume 2026_05_28_elegant_morse
conv: resumed session 2026_05_28_elegant_morse
turns: 23 | provider: claude_code
ready.
Switch between sessions
$ scorpiox-conv --switch 2026_05_27_relaxed_turing
conv: switched → 2026_05_27_relaxed_turing
workspace restored: /home/user/api-server
turns: 112
Create a named session with a specific provider
$ scorpiox-conv --new --name "refactor-auth" --provider claude_code
conv: created session refactor-auth
provider: claude_code
workspace: /home/user/my-project
ready.
Show current session info
$ scorpiox-conv --info
session: 2026_05_29_wonderful_kare
provider: claude_code (opus)
turns: 47
started: 2026-05-29T08:12:03Z
workspace: /home/user/my-project
tokens_in: 142,830
tokens_out: 89,215
Export a session transcript
$ scorpiox-conv --export 2026_05_28_elegant_morse > session.json
conv: exported 23 turns (48.2 KB)
$ scorpiox-conv --export --format markdown | head -40