| name | resume-session |
| description | List in-flight Ouroboros sessions and show the commands needed to re-attach after MCP disconnect |
/ouroboros:resume-session
Recover in-flight Ouroboros sessions after an unexpected MCP server disconnect.
Claude Code reserves /resume for its built-in session picker. This skill
intentionally uses resume-session so it does not shadow that native command.
Usage
ooo resume-session
ooo resume-session --all
/ouroboros:resume-session
Trigger keywords: "in-flight Ouroboros sessions", "re-attach", "mcp disconnected", "lost Ouroboros execution"
How It Works
ooo resume-session reads the EventStore directly (no MCP server required) and lists
every session that is still in a running or paused state. The command is
strictly read-only โ it never creates the data directory, never writes
schema, and never appends events. Its job is to surface the identifiers you
need to re-attach.
ooo resume-session shows the 20 most recent active sessions.ooo resume-session --all shows every active session.
Instructions
When the user invokes this skill:
-
Run the CLI command:
ouroboros resume
This reads ~/.ouroboros/ouroboros.db directly โ the MCP server does not
need to be running.
-
If sessions are listed, enter the number of the session you want to work
with. The command prints both the session_id and the exec_id, along
with the two re-attach paths.
-
Pick the right re-attach path:
-
Inspect only (read-only interactive monitor):
ouroboros tui monitor
Launches the TUI and lets you pick the session to inspect. The
ouroboros status execution <exec_id> command is registered but its
handler is still a placeholder in src/ouroboros/cli/commands/status.py
(it only prints "Would show details for execution: โฆ"), so it is
intentionally not surfaced here. Follow-up tracked as a separate issue.
-
Resume execution (requires the original seed file):
ouroboros run workflow --orchestrator --resume <session_id> <seed.yaml>
Exit codes
| Code | Meaning |
|---|
0 | Success โ sessions listed, or no sessions found |
1 | Invalid user selection (non-numeric or out-of-range) |
2 | EventStore exists but could not be opened or read |
Fallback (No sessions found)
If the command reports "No in-flight sessions found", the execution either
completed, failed, was cancelled, or the EventStore has never been created.
To browse historical sessions interactively, use the TUI monitor:
ouroboros tui monitor
Example
User: ooo resume-session
โโโโโโโโโโโโโโโโโโโโโโโโ In-Flight Sessions โโโโโโโโโโโโโโโโโโโโโโโโ
โ # Session ID Execution ID Status Started โ
โ 1 sess-abc123 exec-xyz789 running 2026-04-15 โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Enter number to re-attach (1-1), or 'q' to quit: 1
โญโ Re-attach โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ Session ID: sess-abc123 โ
โ Execution ID: exec-xyz789 โ
โ โ
โ Inspect (read-only interactive monitor): โ
โ ouroboros tui monitor โ
โ โ
โ Resume execution (requires the original seed file): โ
โ ouroboros run workflow --orchestrator --resume sess-abc123 seed-001 โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
Next Steps
After you have the identifiers:
ouroboros tui monitor โ launch the TUI and pick the session to inspectouroboros run workflow --orchestrator --resume <session_id> <seed.yaml> โ resume executionooo evaluate โ evaluate results once the execution completesooo cancel execution <exec_id> โ cancel if the session is stuck
RFC #1392 State Breadcrumb Footer
Your final response MUST end with exactly one breadcrumb footer line:
โ <current state> โ next: <recommended action>
Derive <current state> from live session state via ouroboros_session_status when that MCP projection is available; otherwise derive it from this skill's actual outcome. Never use a linear Step N of M footer because Ouroboros is an evolutionary loop. When the next action is genuinely a choice, list 2-3 honest options in the next: clause. The breadcrumb line must be the last line of the response.
