Agent role within the repo (e.g. 'reviewer'). Omitted = the default role. Each role runs its own agent; only the default role's logs are uploaded to the cloud.
Agent role within the repo (e.g. 'reviewer'). Omitted = the default role. Each role runs its own agent; only the default role's logs are uploaded to the cloud.
--tail
number
Number of trailing log lines to include
--wait-for-transition-ms
number
Block up to this many milliseconds (capped at 50000) until the child leaves its current in-progress state, then print the status. 0 or absent returns immediately. When set, output is always JSON; omit this flag for default human-readable format.
Repository (ID, full name, or short name) — optional; the picker resolves it when omitted.
--role
string
Agent role within the repo (e.g. 'reviewer'). Omitted = the default role. Each role runs its own agent; only the default role's logs are uploaded to the cloud.
Agent role within the repo (e.g. 'reviewer'). Omitted = the default role. Each role runs its own agent; only the default role's logs are uploaded to the cloud.
Agent role within the repo (e.g. 'reviewer'). Omitted = the default role. Each role runs its own agent; only the default role's logs are uploaded to the cloud.
--scope
"one-time" | "session"
one-time
Grant scope — 'one-time' applies only to this request; 'session' remembers it for equivalent later requests within the child's session
Agent role within the repo (e.g. 'reviewer'). Omitted = the default role. Each role runs its own agent; only the default role's logs are uploaded to the cloud.