Repository ID or org/repo name that should host the main agent. Use "none" or --no-primary to start without a primary repo.
--primary-checkout, --prc
string
What to do with the primary repo: in-place (default, run in the current checkout), fresh-checkout (a fresh copy via the configured strategy), or fresh-checkout-with-changes (a fresh copy with your uncommitted changes applied).
--multiplexer, -m
string
Open delegated child agents in a terminal multiplexer. Defaults to auto. One of: auto, none, tmux, iterm2, kitty, ghostty, cmux, zellij, windows-terminal.
--agent, -a
string
Launch the given agent after the session is created. One of: claude, codex, opencode, auto, skip. When omitted, falls back to the interactive prompt (or 'skip' under --json).
--prompt, -p
string
Initial task instruction passed to the launched agent. Replaces the default "ask the user what to do" trailer in the agent's startup message. Ignored when --launch is skip or omitted.
Only return sessions created on or after this date (YYYY-MM-DD, UTC). Defaults to the last 30 days. Example: --since=2025-01-01
--limit
number
100
Maximum number of sessions to return (1–500, default 100).
--filter, -f
object
Filter sessions under a single object option
--filter.status
string
Match session status (open, archived, stale) using exact values, glob, or CSV patterns. Defaults to active (open) sessions; use '' to include archived and stale. Quote globs, for example 'arch'.
--filter.author
string
Match session authors using case-insensitive substring, glob, or CSV patterns. Defaults to @me, the current user; use '*' to include all authors.
--filter.initiator
string
Match the initiator repository using case-insensitive substring, glob, or CSV patterns. Supports @current.
--filter.repo
string
Match repositories included in a session using case-insensitive substring, glob, or CSV patterns. Supports @current.
--filter.hasPrs
boolean
Filter by whether sessions have at least one linked pull request.
Page size: show N transcript entries per page (default 20). Pass --tail none for the full log. --json returns the full transcript unless --tail or --page is set.
--page
number
1-based page within the --tail-sized windows (default 1 = newest). Higher pages step backward through history.
--repo, -r
string
Show the child agent transcript for one repository (ID, full name, or short name) instead of the parent transcript
--all
boolean
Show the parent transcript plus every child agent transcript
Set the terminal multiplexer for this resume. Defaults to auto. Pass none for no multiplexer. One of: auto, none, tmux, iterm2, kitty, ghostty, cmux, zellij, windows-terminal.
--agent, -a
string | boolean
Choose the agent to resume the session with. Pass claude, codex, opencode, or auto to switch directly, or pass --agent with no value to choose interactively.
Set the terminal multiplexer for this review. Defaults to auto. Pass none for no multiplexer. One of: auto, none, tmux, iterm2, kitty, ghostty, cmux, zellij, windows-terminal.
--agent, -a
string | boolean
Choose the agent to review the session with. Pass claude, codex, opencode, or auto to switch directly, or pass --agent with no value to choose interactively.
--adversarial
boolean
false
Run an adversarial review: the agent loads the adversarial-review skill and spawns an independent reviewer agent per repository.
