Auto-Capture: Claude Code Adapter

Relationship to Upstream Skill

This adapter implements the session-end capture behavior defined by the upstream auto-capture skill by Jared Irish. The base skill is a behavioral protocol, it describes when and what to capture during interactive session closes. This adapter is the concrete Claude Code binding: a Stop-hook script that fires the same capture behavior automatically when a session ends without a verbal trigger. The upstream skill and this adapter are complementary; install both for full coverage.

Problem

The base auto-capture skill requires a verbal trigger ("wrap up", "park this") to fire. In practice, many Claude Code sessions end without that trigger, the user closes the terminal, hits Ctrl+C, or simply walks away. Those sessions and their decisions are lost.

What This Adapter Adds

This adapter uses Claude Code's hook system to run a capture script automatically at session end. It complements the base auto-capture skill:

• Base auto-capture handles interactive session-close captures (ACT NOW items, session summaries) when the user explicitly wraps up.
• This adapter handles ambient capture when the session ends without an explicit trigger (terminal close, timeout, Ctrl+C).

Together they ensure no valuable session falls through the cracks.

How It Works

1. Claude Code fires a Stop hook at session end, passing the transcript path and session metadata via stdin as JSON.
2. The hook script (session-end-capture.mjs) reads the transcript, filters out short or agent-only sessions, and formats the content.
3. The formatted transcript is POSTed to the Open Brain REST ingest endpoint (or smart-ingest edge function) for automatic thought extraction.
4. Failed captures are saved to a local retry queue and retried on subsequent session ends.

Skip Heuristics

Not every session is worth capturing. The hook skips: