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 upstarted - 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