Skip to main content

corgi agent

corgi agent​

Keep Claude Code Remote Control running for your corgi workspaces

Synopsis​

Agent mode makes this machine an always-on, multi-repo Remote Control host.

Remote Control already gives you a phone-driven Claude Code session on your own machine. Two things stop it being always-on: the local process must keep running, and it exits after roughly ten minutes awake without network.

corgi agent supervises it - restarting after a network timeout, holding a wake lock so the machine does not sleep mid-session, and running one per workspace under that workspace's own Claude config directory.

Getting started: corgi agent init # in a stack, once corgi agent install # start at login corgi agent status # what is running, and under which account

Options​

-h, --help help for agent

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
--isolate string Run this workspace under a named lease: own port block, own database names, own containers
--json Emit machine-readable JSON output
--privateToken string Private token for private repositories to download files
-o, --runOnce Run corgi once and exit
--silent Hide all welcome messages

SEE ALSO​

  • corgi - Corgi cli magic friend
  • corgi agent answer - Answer a session's permission prompt from anywhere
  • corgi agent approve - Approve a Claude connector sign-in waiting on this machine
  • corgi agent ask - Ask the chief about the board: what to look at first, what is blocked, who is on what
  • corgi agent attempts - Compare the sessions a fan-out opened on a ticket, and pick one
  • corgi agent awake - Keep this machine awake for as long as the agent daemon runs
  • corgi agent away - Set this machine up to work alone for weeks, and say what only you can do
  • corgi agent board - Show or set how many keys the session board has
  • corgi agent bot - Named sessions you come back to: a workspace, a persona, a model, a thread
  • corgi agent brief - What the last supervised session was working on before it restarted
  • corgi agent cap - A token budget for every session, or for one
  • corgi agent carry - Continue a session under another account, conversation and all
  • corgi agent chat - Speak in the chat corgi listens to
  • corgi agent claim - Say which files this session is on, so another session in the repository is told
  • corgi agent claims - Who holds which files, across the board
  • corgi agent claude - Run Claude Code the way this folder's workspace is configured
  • corgi agent codex - Run Codex the way this folder's workspace is configured
  • corgi agent container - Run the agent daemon in a Docker container, here or on a server over ssh
  • corgi agent continue - Let the daemon continue a limited session when its limit is over
  • corgi agent cost - What the agents cost: tokens by repo, by day, or by bot
  • corgi agent dashboard - Open the dashboard in this machine's browser
  • corgi agent digest - Today's one-message summary, as the daily digest would send it
  • corgi agent dismiss - Take a finished session off the board until its next event
  • corgi agent doctor - Check whether agent mode can actually work here
  • corgi agent down - Stop everything corgi agent up started - the daemon and the detached MCP + tunnel
  • corgi agent event - Report one event from an agent that is not Claude Code, so it sits on the board
  • corgi agent focus - Bring a session's window to the front and reveal its terminal tab
  • corgi agent guard - A pre-push hook that refuses a branch whose session's gate or tests are red
  • corgi agent handoff - Leave a typed handoff for the next run on this ticket
  • corgi agent hands - Let agents on a peer Mac (or this one) look at and use this Mac, and do it from here
  • corgi agent harden - Write the safe defaults into this workspace's Claude settings
  • corgi agent heat - What the daemon does when the laptop gets hot in a bag
  • corgi agent history - What was worked on, day by day: runs, merges, finished tasks, cards that left
  • corgi agent hooks - Get notified when a session in this workspace needs you
  • corgi agent hotspot - Hop onto your phone's hotspot when the internet is gone for a while
  • corgi agent init - Opt this stack into agent mode
  • corgi agent install - Start agent mode at login (launchd on macOS, systemd on Linux)
  • corgi agent interrupt - Stop what a session is doing - Escape, as you would press it
  • corgi agent kanban - One card per ticket: Inbox, Ready, Running, Blocked, Review, Done
  • corgi agent later - A one-off reminder: ring the phone, or type into a session, at a time
  • corgi agent left - What unattended runs left for a person, ticked off as CI goes green, pull requests merge or you say so
  • corgi agent lesson - What this workspace learned the hard way - read by every new session
  • corgi agent level - How much of a workspace runs without you: see it, or set it for this workspace
  • corgi agent lid - Ring the phone when this laptop wakes or its lid opens by day; lock or shut it down from there
  • corgi agent logs - Show a workspace's session timeline (starts, exits, why)
  • corgi agent mute - Nothing rings for a while - no toast, no push; the board goes on
  • corgi agent new - Open a new agent session (Claude Code, or codex with --agent) in the editor window in front
  • corgi agent note - Put your own line under a session on the board
  • corgi agent notify - Where notifications go when you are away from this machine
  • corgi agent page - Turn the board's overflow page when more sessions run than keys
  • corgi agent pair - Open a fresh pairing window and print its QR - or write a .corgipair file to AirDrop
  • corgi agent peers - The other laptops on your trackers: who leads, who is awake
  • corgi agent pin - Reserve a key for the session on it (--off to release)
  • corgi agent plan - A planner breaks a goal into tasks on the board; the daemon works through them, a worktree each
  • corgi agent pr-body - A pull request description from the session that made the branch
  • corgi agent profile - Manage named Claude account profiles for remote session start
  • corgi agent pulse - Ping a URL every five minutes so a service alarms you when this machine goes quiet
  • corgi agent refresh - Reload everything now: rescan sessions, poll every tracker, publish
  • corgi agent rescan - Look for running Claude sessions no hook has reported
  • corgi agent resolve - Show which workspace a name resolves to, without starting anything
  • corgi agent restart - corgi agent down && corgi agent up --fresh, in one command
  • corgi agent routine - Runs on a clock: digest, babysit-pr, deps, release-notes, flaky, doc-drift, suggest, lessons, or your own
  • corgi agent scan - Find corgi stacks under a directory and register them
  • corgi agent scenario - End-to-end stories a change is judged against, kept where the session building it does not look
  • corgi agent scope - The contract a ticket's change stays inside: paths, a diff budget, done-when
  • corgi agent scorecard - What the unattended runs came to: pushed, green, failed or idle, by workspace and kind
  • corgi agent screen - Your Mac's screen on your iPhone, iPad or another Mac: turn it on, grant devices, end sessions
  • corgi agent selfcheck - What kept going wrong in the unattended runs: checks they skipped and why, machine failures, money on runs that found nothing, items still left for you
  • corgi agent send - Type text into a session's terminal, after bringing it forward
  • corgi agent serve - Supervise Remote Control for every enabled workspace
  • corgi agent session - Start or stop a supervised session in a workspace, on demand
  • corgi agent sessions - Show every tracked Claude Code session as the board of keys
  • corgi agent skills - The corgi skills for agents other than Claude: install and check them for Codex
  • corgi agent standup - What you and Claude did, per workspace, since yesterday
  • corgi agent status - Show what agent mode is running, and under which account
  • corgi agent stop - Stop the agent daemon
  • corgi agent stream - Which workspaces a paired phone may read as a conversation
  • corgi agent task - Tasks of your own on the board: add one for later, pick it up, move it along
  • corgi agent term - A shell on another corgi machine - a Linux server, a peer laptop - with no ssh keys or open ports
  • corgi agent timeline - What happened in a session, in order: prompts, tool bursts, tests, the pull request and its reviews
  • corgi agent today - What has been done today - yours and the watch's
  • corgi agent top - The board in the terminal, live: every session, its standing, what it is doing
  • corgi agent track - Track every Claude Code session on this machine for a Stream Deck or the CLI
  • corgi agent transcript - A session's conversation: the newest entries, or everything after an offset
  • corgi agent tunnel - Set up the permanent launcher URL
  • corgi agent turn - One more turn for a session whose terminal is gone - claude -p --resume, or codex exec resume
  • corgi agent undo - Drop what a session left uncommitted in its own worktree; --worktree drops the worktree and its branch too
  • corgi agent uninstall - Stop starting agent mode at login
  • corgi agent up - One command from a stack directory to phone-startable: register, daemon, tunnel, pairing
  • corgi agent usage - Every account's limits, where they are heading, and today's numbers
  • corgi agent wake - Wake a sleeping peer Mac on this network (Wake-on-LAN)
  • corgi agent watch - Watch the tracker and your pull requests: new issues, new comments, reviews - notify, or fix
  • corgi agent while-away - What happened while you were gone
  • corgi agent windows - List the editor windows the corgi VS Code extension has connected
  • corgi agent workspaces - List and manage the workspaces agent mode knows about
Auto generated by spf13/cobra on 16-Nov-2026​