Skip to main content

corgi agent watch enable

corgi agent watch enable​

Watch this workspace (run inside it)

corgi agent watch enable [flags]

Options​

--action string notify (default) or fix - fix starts a headless claude with the matching skill, draft PRs only
--after-merge corgi agent watch board Move the ticket to this column once every pull request of its run is merged - a name from corgi agent watch board; empty leaves it where it is
--after-merge-subtasks string Where a subtask goes instead when its pull request merges (Done, say); empty means the same column as --after-merge
--agents strings The agents to try in order, e.g. claude,codex: the next takes a run when the first cannot
--approve An unattended review of a pull request I was asked to review may approve it when nothing blocks and the risk card allows
--assignee string me (default) or any
--auto Shorthand for --action fix --prs --comments (not --reviews: reviewing someone else's PR is a separate ask): work on what arrives without being asked, draft PRs only
--auto-allow string Answer a permission prompt for a tool that only reads - Read, Grep, Glob, a web search, a question for you - on the daemon's own: reads, or off (Bash always waits for a person; iTerm2 and tmux sessions only)
--auto-carry Carry a session that hit its five-hour quota to another of the workspace's accounts with budget, once per limit (only profiles the accounts list names)
--auto-for string With --action fix, what to work on unattended: tickets, comments, reviews (comma separated). Empty means everything
--auto-merge Merge a pull request of mine the moment its checks pass and it is approved (read from the forge once a round)
--batch int Tickets that arrive within 90 s of each other share one run, up to this many (1 is off); one preflight and one context for the lot (default 1)
--bots Comments from bot accounts count too (a review bot whose findings are to be fixed); off, a bot is not a person waiting
--channel strings Slack channels every message of which is news, e.g. #incidents (repeatable)
--ci Also builds that went red on something of mine - the one kind that brings its own test for done
--comments Also new comments on issues assigned to me
--compact-at int Type /compact into a session past this much context the next time it stops - 85 is where the board goes red; 0 is off
--days-off string Days the watch sleeps through - weekends, or sat,sun, or mon,fri: no polling, no fix, nothing rings until the next working day (none clears)
--done-when go test ./...,pnpm lint What finished means here, comma separated: commands run in the session's directory when it stops with changes - go test ./...,pnpm lint; a red one is typed back as the next message. Empty is off
--errors Take new errors into the inbox, from Sentry and from alert webhooks; you pick which to work on (--auto-for errors runs them by itself)
--from string Only comments and reviews from these people (comma separated); empty is anyone
--hand-over Type a review comment, a red build or an asked-for review into the session already on that branch
--headless Let a message for a session whose terminal is gone run as one headless turn (claude -p --resume, or codex exec resume; acceptEdits) in its own checkout, so the phone's chat keeps working
-h, --help help for enable
--interval string Poll interval, e.g. 3m; 0 means webhooks only
--isolate Give every unattended run its own worktrees on a corgi/<ref> branch, so it never touches your checkout
--kind string The agent that runs here: claude (default) or codex; also what corgi agent claude opens in this workspace
--labels string Only issues with one of these labels (comma-separated), e.g. bug,defect
--lease Claim a ticket on the tracker before working it, so a second machine watching the same board leaves it alone
--lessons Write what the workspace learned the hard way - a review on a PR of mine, a check that stayed red, a bot that failed - one line each for every new session to read (corgi agent lesson list)
--limit-ceiling int With --action fix: the usage-window percent past which no run starts here (default 95; 100 never waits on usage, only on the caps)
--max-per-day int With --action fix: at most this many fixes a day (default 10)
--max-per-hour int With --action fix: at most this many fixes an hour (default 3); more are deferred
--max-total int With --action fix: at most this many fixes in total, counted from now - a cap for a trip; run enable --max-total again to reset, 0 clears
--mentions Ring when someone names you in Slack or writes to you directly (needs corgi agent watch auth slack)
--merge-unread Merge low-risk pull requests a run opened with nobody reading them: green, small, away from auth, payments, data, CI and dependencies, and they satisfy the hidden scenarios. The rest waits for you. Usually set with corgi agent level 5
--night-shift Work through the quiet hours: fixes and routines run as by day, nothing rings until the quiet hours end, then one 'N while you were away' says what happened (--night-shift=false to sleep through them again)
--no-retry watch run Leave deferred fixes to a manual watch run instead of starting them when the budget returns
--pickup string Column a ticket moves to when it is picked up, e.g. "In Progress"; empty writes nothing
--plan-review string Stop for a human before code on a story: always, risk>=N (the story's forecast, 1 to 10), or off. Off means the stories skill gates as today; on, the spec waits for an answer - from the terminal or the phone - before a branch is cut
--post-to string Default Slack channel for corgi agent chat post
--project string Linear team key or Jira project key, e.g. ABC
--prs Also reviews and comments on pull requests I opened
--prune-after watch undo Remove an isolated run's worktrees this long after it finished, e.g. 7d; the branch stays, a dirty worktree stays (empty keeps them until watch undo or `watch prune`)
--quiet string Local hours to stay quiet in, e.g. 23:00-07:00: no fix starts and nothing buzzes; one summary when it opens
--rebase Rebase a session's branch onto main where it sits when the session stops behind main with a clean tree and no conflicts (a branch that would conflict is typed into the session under --hand-over)
--reply-as string Whose voice a reply speaks in: bot or me (default: the bot when a bot token is stored)
--repos string GitHub repos to watch for PR feedback, comma-separated owner/repo (default: any)
--rerun-ci Rerun the failed jobs of a red build once before it is worked on or handed over; a second red on the same run goes the usual way (GitHub, GitLab)
--review-channel strings Slack channels where pull requests are posted for review: a post with links is one review, answered in its thread (repeatable)
--review-delay string Hold a review someone asked for this long before it runs, e.g. 1h; it is checked again then - merged, closed or already reviewed drops it (empty or 0 reviews at once)
--review-status string Column a ticket moves to once a run opened a pull request for it, e.g. "In Review"
--reviews Also pull requests someone asked me to review - theirs, not mine
--run-db string How an isolated run gets databases: own (empty ones on ports nobody else uses, the default), shared (the workspace's own, read only - for a database too big to copy) or off (default "own")
--sentry-level string The quietest Sentry level that counts: info, warning, error (default) or fatal
--sentry-org string Sentry organization to read new errors from (implies --errors); the token: corgi agent watch auth sentry
--sentry-project strings Only these Sentry projects, comma separated
--silent Nothing about this workspace's watch rings - no toast, no phone push: fixes run, the inbox and the kanban fill, and you look when you like (--silent=false to ring again)
--slots int How many unattended runs may go at once in this workspace (1 to 8); above 1 turns on --isolate so each has worktrees of its own (default 1)
--states string Only issues in one of these states, e.g. Todo,Backlog
--tracker string linear or jira (default: whichever has a token)
--trust strings Colleagues whose Slack mention may start an unattended run - the person who WROTE the message, e.g. @teammate (repeatable). Empty means nobody: a mention only rings
--workspace string Workspace id to change; omitted means the one you are in

Options inherited from parent commands​

--describe Describe contents of corgi-compose file
--dockerContext string Specify docker context to use, can be default,orbctl,colima (default "default")
-l, --exampleList List examples to choose from. Click on any example to download it
-f, --filename string Custom filepath for for corgi-compose
--fromScratch Clean the .corgi/corgi_services folder before running
-t, --fromTemplate string Create corgi service from template url
--fromTemplateName string Create corgi service from template name and url
-g, --global Use global path to one of the services
--interactive Force interactive prompts even when no TTY/agent detected
--json Emit machine-readable JSON output
--privateToken string Private token for private repositories to download files
-o, --runOnce Run corgi once and exit

SEE ALSO​

  • corgi agent watch - Watch the tracker and your pull requests: new issues, new comments, reviews - notify, or fix
Auto generated by spf13/cobra on 16-Nov-2026​