# Guides


<a href="../../docs/guide/commands.html" class="section-card" style="display: block; padding: 1.25rem 1.5rem; border: 1px solid #dee2e6; border-radius: 0.5rem; color: inherit; text-decoration: none;"></a>


Inspect and rewrite commands


Match, question, walk, and rewrite the Bash command an agent is about to run.


<a href="../../docs/guide/external-transcripts.html" class="section-card" style="display: block; padding: 1.25rem 1.5rem; border: 1px solid #dee2e6; border-radius: 0.5rem; color: inherit; text-decoration: none;"></a>


Register an external transcript


<a href="../../docs/guide/how-it-works.html" class="section-card" style="display: block; padding: 1.25rem 1.5rem; border: 1px solid #dee2e6; border-radius: 0.5rem; color: inherit; text-decoration: none;"></a>


Under the hood


The dispatch pipeline, verdict precedence, the trust model, and the resident daemon.


<a href="../../docs/guide/limitations.html" class="section-card" style="display: block; padding: 1.25rem 1.5rem; border: 1px solid #dee2e6; border-radius: 0.5rem; color: inherit; text-decoration: none;"></a>


What captain-hook does not do


The blunt list: what capt-hook deliberately does not do.


<a href="../../docs/guide/llm-hooks.html" class="section-card" style="display: block; padding: 1.25rem 1.5rem; border: 1px solid #dee2e6; border-radius: 0.5rem; color: inherit; text-decoration: none;"></a>


LLM hooks, signals & the transcript


Put a model's judgment in a hook -- LLM gates and nudges, signal scoring, and transcript queries.


<a href="../../docs/guide/packs.html" class="section-card" style="display: block; padding: 1.25rem 1.5rem; border: 1px solid #dee2e6; border-radius: 0.5rem; color: inherit; text-decoration: none;"></a>


Packs & configuration


Use the packs you have, ship your own in a Claude plugin, and tune hook settings.


<a href="../../docs/guide/primitives.html" class="section-card" style="display: block; padding: 1.25rem 1.5rem; border: 1px solid #dee2e6; border-radius: 0.5rem; color: inherit; text-decoration: none;"></a>


Writing hooks


Primitives, conditions, and style rules -- the vocabulary every hook is built from.


<a href="../../docs/guide/session-reviewer.html" class="section-card" style="display: block; padding: 1.25rem 1.5rem; border: 1px solid #dee2e6; border-radius: 0.5rem; color: inherit; text-decoration: none;"></a>


Session reviewer


How repeated corrections become hooks: the reviewer, its thresholds, and the PR it opens.


<a href="../../docs/guide/state.html" class="section-card" style="display: block; padding: 1.25rem 1.5rem; border: 1px solid #dee2e6; border-radius: 0.5rem; color: inherit; text-decoration: none;"></a>


State & workflows


Typed session state, durable state, and multi-step workflow gates.


<a href="../../docs/guide/testing.html" class="section-card" style="display: block; padding: 1.25rem 1.5rem; border: 1px solid #dee2e6; border-radius: 0.5rem; color: inherit; text-decoration: none;"></a>


Test hooks inline


Inline tests={…}, the test runner, and replaying recorded sessions.


<a href="../../docs/guide/troubleshooting.html" class="section-card" style="display: block; padding: 1.25rem 1.5rem; border: 1px solid #dee2e6; border-radius: 0.5rem; color: inherit; text-decoration: none;"></a>


Troubleshooting


Symptom-by-symptom fixes for hooks that don't fire, fire wrong, or fire twice.
