Overview
Context Recall is the read surface through which an agent recalls, mid-work, the captures that context-capture stores in local git (refs/heads/aiflare/v1) on every commit. Right after a file edit, a hook announces that file's capture history as a one-line signal, and the agent pulls depth in stages with the aiflare recall CLI — capture timeline, then a single capture in full, then the conversation excerpt. It fully replaces context-inject, where a human copied a sessionId from the web dashboard to inject a report.
Use Cases
Particularly effective in the following situations.
When work heads toward a direction a past session reviewed and discarded, the agent warns the user, quoting the rejection reason.
When starting work on a feature area with capture history, recall the relevant intent and decisions first and start from the record, not guesswork.
The moment a file is edited, its past capture count and the latest title arrive as one line — code with history never slips by unnoticed.
Search titles, intent, and alternatives with --grep to find past decisions even when you don't know the file path.
Usage Guide
Automatic Signal
When a file is edited in Claude Code, a PostToolUse hook queries local git captures and adds a one-line signal in the format below to the agent's context. It stays silent for files with no captures and never blocks the editing flow, regardless of failure.
[aiflare] 3 past captures for this file (latest: 'Cap payment retries', 2026-05-14)Recall CLI — Three Modes
On receiving a signal, the agent (or a human) pulls exactly as much depth as needed with aiflare recall. Every query reads local git only — no server or network required.
aiflare recall --file <path|dir>Lists the capture timeline for a file or directory. Intent and rejected alternatives are included right at the list stage.
aiflare recall --grep <keyword>Searches titles, intent, alternatives, and diff summaries by keyword. The discovery tool when you don't know the file path.
aiflare recall --id <captureId>Fetches one capture in full, including the diff summary. Add --with-conversation to see the original conversation excerpt.
Interpretation Contract
If the intended direction matches a rejected alternative, the agent quotes the rejection reason — but never changes course on its own. The decision belongs to the user.
intentSource NONE means a facts-only diff description with no conversation evidence. Limitations are always disclosed before the payload.
The agent never invents intent that isn't in the captures. If the captures can't explain something, it says so.