corgi agent track

Track every Claude Code session on this machine for a Stream Deck or the CLI

Synopsis

Session tracking installs hooks into your Claude Code account settings (~/.claude/settings.json, and each profile's config directory) that report every session's status to the corgi daemon: working, needs you, done, idle. The daemon keeps them on a fixed board of keys and publishes it as sessions.json for a Stream Deck plugin; corgi agent sessions prints the same board and corgi agent focus brings a session's window to the front.

Every hook is asynchronous and exits 0 whatever happens: a daemon that is down costs nothing and shows nothing in the transcript. The one exception prints a terminal title (● repo / ▲ repo NEEDS YOU) into the tab the session runs in, which VS Code and most terminals show — --no-tab-title skips it.

corgi agent track enable # this account, plus every corgi profile corgi agent track enable --config-dir ~/.claude-work corgi agent track enable --slots 15 # a bigger deck corgi agent sessions # the board corgi agent focus acme-api # the window and tab it runs in

Options

  -h, --help   help for track

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

corgi agent track