Skip to main content

corgi agent up

corgi agent up​

One command from a stack directory to phone-startable: register, daemon, tunnel, pairing

Synopsis​

Does the whole remote-session-start setup in one shot:

  1. registers the current stack in the workspace registry (if run in one)
  2. starts the agent daemon in the background (if not already running)
  3. starts the MCP endpoint with a public tunnel and a pairing window (if not already listening)

Everything runs detached, so an AI agent can run this and keep working. Prints the public URL and the pairing code; --json emits the same as JSON.

corgi agent up [flags]

Options​

      --fresh                                   Replace a corgi MCP already holding the port: new tunnel + a new single-use pairing window (a phone mid-session on the old URL is cut)
  -h, --help                                    help for up
      --http string                             Local MCP address. Use 0.0.0.0:8765 to also serve phones on the same Wi-Fi, which needs no tunnel at all (default "127.0.0.1:8765")
      --provider string                         Tunnel provider (cloudflared|ngrok|localtunnel)
      --tunnel-hostname string                  Public hostname of the named tunnel, e.g. corgi.yourdomain.com (the DNS name routed to it; ngrok: your free static domain). Remembered for the next up/restart; pass "" to go back to a quick tunnel
      --tunnel-name cloudflared tunnel create   cloudflared named-tunnel name — a stable public URL you can bookmark, and a phone that stays paired (needs a one-time cloudflared tunnel create and --tunnel-hostname; see docs/agent.md)

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 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 31-Aug-2026​