Skip to main content

corgi checkout

corgi checkout

Checkout every repo to a branch and pull it

Synopsis

Puts the workspace repo and every service repo on <branch>, then fast-forwards it.

A repo that does not carry that branch falls back to its own default branch (origin/HEAD), so "corgi checkout main" still lands next to a repo whose trunk is called master. A repo that can do neither is reported and the command exits 1.

Without <branch> every repo goes to its own default branch.

Repos with uncommitted changes are skipped, not clobbered.

corgi checkout [branch] [flags]

Examples

corgi checkout main

corgi checkout trunk --service api --service web

corgi checkout --json

Options

--allow-dirty Try even with uncommitted changes (git still refuses an unsafe switch)
-h, --help help for checkout
--service stringArray Only these services (repeatable, or comma separated). Leaves the workspace repo alone
--skip-workspace Leave the repo holding corgi-compose.yml on its current branch

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 - Corgi cli magic friend
Auto generated by spf13/cobra on 31-Aug-2026