Skip to main content

corgi logs

corgi logs​

Browse and follow persisted service logs

Synopsis​

Browse logs captured by corgi run (capture is on unless --logs=false).

Without flags: interactive picker - choose a service then a run, and the log is streamed to stdout (follows new writes like tail -f).

Examples: corgi logs # interactive picker corgi logs --service api # jump straight to run picker for "api" corgi logs --all # merge the newest run of every service into one stream corgi logs --session # corgi's own output for the last run corgi logs --idle 0 # tail forever (until Ctrl-C) corgi logs --prune # delete all .logs/ directories

Waiting, for scripts and agents: corgi logs --service api --wait-for "Listening on" --timeout 90s corgi logs --service api --since 5m --grep "ERROR" --json

--wait-for blocks until a line matches, then exits 0. It exits 1 on timeout, so a shell step can gate on it without parsing output.

corgi logs [flags]

Options​

--all Merge the newest run of every service into one timestamp-sorted stream
--dump string Copy the newest run of every service into this directory and exit (for CI artifacts)
--grep string Only show lines matching this regexp
-h, --help help for logs
--idle duration Exit after this much dead-air on the file (set 0 to tail forever) (default 30s)
--prune Delete all captured log files (corgi_services/.logs/)
--service string Service name to show logs for (skips service picker)
--session Show corgi's own run output (validation errors, port conflicts, resolved branches) instead of a service's
--since string Only show lines newer than this (duration like 5m, or an RFC3339 timestamp)
--timeout duration How long --wait-for waits before giving up (default 1m0s)
--wait-for string Block until a line matches this regexp, then exit 0 (exit 1 on timeout)

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
Auto generated by spf13/cobra on 22-Sep-2026​