Skip to Content

ah session

Inspect, steer, attach to, rewind, or fork local and remote agent sessions.

Inspection & Control Subcommands

SubcommandDescription
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

SubcommandDescription
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.