AI-Cognitive-Leap/agnes-the-ai-analyst
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(hooks): update install_claude_hooks docstring for chained SessionStart

Browse source
This commit is contained in:
ZdenekSrotyr 2026-05-06 16:06:57 +02:00
parent be62ce61b8
commit 73d2896fa6
1 changed files with 4 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

7
cli/lib/hooks.py
View file

@ -7,8 +7,9 @@ without dragging in the deleted command module.
Design notes: Design notes:
- Workspace-scoped (`<workspace>/.claude/settings.json`), NOT user-home. - Workspace-scoped (`<workspace>/.claude/settings.json`), NOT user-home.
The hooks fire only when Claude Code opens this workspace. The hooks fire only when Claude Code opens this workspace.
- Idempotent: second invocation drops a prior `agnes pull` / `da sync` / - Idempotent: second invocation drops a prior `agnes self-upgrade` /
`agnes push` entry (matched by command substring) and appends fresh entries. `agnes pull` / `da sync` / `agnes push` entry (matched by command substring)
and appends fresh entries.
Third-party hooks (mixed entries, foreign commands) are left alone. Third-party hooks (mixed entries, foreign commands) are left alone.
- Uses `|| true` in the hook command so the hook never blocks a session on - Uses `|| true` in the hook command so the hook never blocks a session on
a transient sync error. a transient sync error.
@ -28,7 +29,7 @@ _OUR_COMMAND_MARKERS = ("agnes self-upgrade", "agnes pull", "agnes push", "da sy
def install_claude_hooks(workspace: Path) -> None: def install_claude_hooks(workspace: Path) -> None:
"""Install SessionStart->`agnes pull` and SessionEnd->`agnes push` hooks. """Install SessionStart->`agnes self-upgrade; agnes pull` and SessionEnd->`agnes push` hooks.
Idempotent. Workspace-scoped (writes `<workspace>/.claude/settings.json`). Idempotent. Workspace-scoped (writes `<workspace>/.claude/settings.json`).
Preserves third-party hooks and other event types. Preserves third-party hooks and other event types.