Skip to main content

corgi agent pair

corgi agent pair

Open a fresh pairing window and print its QR — or write a .corgipair file to AirDrop

Synopsis

The MCP server corgi agent up started keeps serving; this asks it for a new single-use pairing code (ten minutes) and prints the QR and the link, the way agent up did.

corgi agent pair a new QR and code corgi agent pair --viewer a read-only window, for a teammate's phone corgi agent pair --file also write ~/Desktop/<laptop>.corgipair: AirDrop it to the phone, which opens it with corgi and is paired — no scanning, no typing corgi agent pair --mint a launch code for a daemon you will start without a terminal: corgi agent up --pair-code <code> on that host opens its first window on it corgi agent pair --json

The file holds the code and the address, nothing that lasts: the code dies in ten minutes or on first use, and the phone's own token is minted on the laptop when it pairs. AirDrop carries it end-to-end encrypted between your devices.

corgi agent pair [flags]

Options

--file Also write ~/Desktop/<laptop>.corgipair to AirDrop to the phone
-h, --help help for pair
--mint corgi agent up --pair-code Print a fresh launch code and exit; hand it to corgi agent up --pair-code on a headless host
--viewer A window whose phone only reads the board

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 agent - Keep Claude Code Remote Control running for your corgi workspaces
Auto generated by spf13/cobra on 20-Sep-2026