git:20260804.9eab0d7 to git:20260805.d306976

4 added, 1 removed. Audit A to A.

---

name: hook-setup

description: >

Inspect and install CCAM monitoring hooks for Claude Code and Codex. Use when

onboarding a provider, repairing missing hooks, checking which provider is

active, or validating that installation preserved unrelated user hooks.

---

# Hook Setup

1. Inspect current state: `ccam hooks status`.

2. Show which provider hooks are missing or will be replaced.

3. Install only after confirmation:

```bash

- ccam hooks install claude codex --yes

+ ccam hooks install <selected-or-missing-providers> --yes

```

+ Replace the placeholder with `claude`, `codex`, or `claude codex` based on the

+ user's selected scope and the missing providers reported by `ccam hooks status`.

4. Read back `ccam hooks status`.

5. Start a real provider session and verify a new session/event reaches CCAM.

Installers replace only CCAM-owned entries and preserve unrelated hooks.

Hook execution must remain fail-safe and non-blocking.