ah session
Inspect, steer, attach to, rewind, or fork local and remote agent sessions.
Inspection & Control Subcommands
| Subcommand | Description |
|---|---|
ah session list [--all] [--executor <name>] [--json] | Lists active and historical sessions across your local daemon and fleet. |
ah session status <id> [--json] | Prints the current lifecycle state, token consumption, and active branch of <id>. |
ah session view <id> [--follow] [--json] | Views the structured turn-by-turn conversation and tool call log. |
ah session attach <id> | Attaches your terminal directly to the live interactive PTY of session <id>. |
ah session prompt <id> "<text>" [--wait] | Sends a prompt or steering instruction to a running or idle session. |
ah session logs <id> [--tail <n>] [--follow] | Streams raw stdout/stderr and supervisor telemetry logs. |
ah session stop <id> | Gracefully terminates the running session. |
Time Travel & Hierarchy Subcommands
| Subcommand | Description |
|---|---|
ah session timeline <id> | Displays the chronological sequence of turns, tool calls, and synchronised CoW snapshots. |
ah session snapshots <id> | Lists all CoW filesystem snapshots captured during session <id>. |
ah session seek <id> --to-turn <N> | Rewinds both the session’s conversation state and workspace filesystem to Turn <N>. |
ah session branch <id> --at-turn <N> --name <branch> [--prompt "<text>"] | Forks a new child session and CoW workspace branch starting from Turn <N> of session <id>. |
ah session branches <id> | Lists all sessions forked from <id> via ah session branch. |
ah session children <id> | Lists all child sub-agent sessions spawned from inside session <id>. |
ah session tree [<id>] | Renders the complete parent/child and fork hierarchy tree of sessions and CoW branches. |