Skip to main content

corgi agent hooks enable

corgi agent hooks enableโ€‹

Notify when a Claude session here asks for permission or finishes

Synopsisโ€‹

Writes Claude Code hooks into .claude/settings.local.json (local to this machine, never committed): one for permission prompts and questions, one that names a session after the first thing you ask it, and with --turns one for a finished turn. They call corgi agent hook, which tells the corgi daemon, which sends the same notification as a restart - including the phone push when notifyUrl is set.

The naming one answers nothing to the daemon: it replies to Claude Code with a title, so "corgi ยท main ยท 18:55" becomes "corgi ยท fix the login redirect" as soon as you say what you want. It only ever replaces a name corgi composed or Claude Code derived - one you typed, or one it already set, is left alone - and --no-title skips it entirely.

By default only the first: a permission prompt blocks the session until you answer it, while a finished turn is just noise once several workspaces are busy. Add --turns if you do want one on every turn.

Claude also nudges after about a minute of no input, with nothing blocked. corgi drops that one - it is the notification that arrives when the session wants nothing, and it is why people stop reading them. --idle keeps it.

Covers every Claude session in the directory, not just supervised ones.

--all does the same for every registered workspace, so a machine with several stacks does not need one visit each.

corgi agent hooks enable [flags]

Optionsโ€‹

--all Apply to every registered workspace, not just this directory
-h, --help help for enable
--idle Also notify on Claude's "waiting for your input" nudge, which fires when nothing is actually blocked
--no-title Do not name sessions after the first thing you ask them
--turns Also notify when a session finishes a turn (noisy across several workspaces)

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โ€‹

Auto generated by spf13/cobra on 16-Nov-2026โ€‹