Coding agents flood their own context with grep dumps and re-read files, then forget your conventions between sessions. OpenWolf gives Claude Code, Codex, OpenCode, and other agents one persistent project brain: verbose output governed before it enters context, a durable project index, memory that survives compaction, and every saving measured from your agent's own transcripts. No workflow changes.
Before building 2.x we audited 16 live projects: 6,869 real API calls of transcripts. Nearly half of all tool-result tokens arrived through Bash: grep floods, git show dumps, test logs, whole files printed with cat. And every one of those tokens is re-read from cache on every later API call for the rest of the session. The cost of a byte is not its size. It is its size times every call that follows.
So OpenWolf governs the Bash channel at the source, keeps context healthy across long sessions, and measures everything it claims from your agent's own transcripts. Including its own overhead.
OpenWolf hooks into your agent's lifecycle. No commands to remember. It just makes every session smarter.
grep floods, git show dumps, and file re-prints are condensed structurally before they enter context. The full output stays on disk with a pointer. Test failures are never touched. The saving is measured per call, at the rewrite point.
Real usage from every transcript, per model. Hook delivery verified against the harness's own records. Cache rebuilds attributed to their trigger and cost. If OpenWolf claims it, it can prove it.
A ~400-token index of your project state at session start. Rules re-surfaced on a cadence to counter within-session decay. Compaction restores the path-scoped rules the platform documents as lost.
openwolf find answers location queries in under 1k tokens. openwolf map ranks the important files by personalized PageRank over the import graph. Tree-sitter symbols give exact line ranges for slice reads.
Conventions, corrections, and bug fixes live in files that travel through git and code review, readable by every agent and every teammate. On Claude Code, they sync both ways with native auto-memory.
Heartbeats on every hook, a session-start self-test, and install verification on every update. A hook cannot die silently. Plus loopback-only token-auth dashboard, zero shell interpolation, and secrets excluded from every index.
Run one command in any project. Creates .wolf/ directory, registers hooks, scans all files.
Just use claude as you always do. Hooks fire invisibly, tracking, learning, enforcing. You don't interact with any of it.
Every session, OpenWolf learns preferences, logs bugs, and governs output. The dashboard shows tokens verifiably kept out of context, hook health, and what broke your prompt cache.
.wolf/ directoryEvery project gets a .wolf/ folder containing state, learning memory, and configuration. Markdown is the source of truth.
Durable project index: descriptions, token estimates, content hashes, symbols, and the import graph. Rendered to anatomy.md.
Learned preferences, conventions, Do-Not-Repeat mistakes. Budgeted, committed, shared across agents and teammates.
Session handoff. Regenerate it with /handoff; the next session reaches productive context in one small read.
Bug and fix memory with full-text search. The pre-write hook recalls relevant past fixes before an edit repeats them.
10 Node.js lifecycle hooks shared by all wired agents. Pure file I/O, no network, no AI calls, heartbeat-monitored.
Estimated, measured, and transcript-verified usage per session and agent, plus governor deltas and cache-rebuild attribution.
Ten hooks fire on every agent action. Heartbeat-monitored, never permission-bypassing. Pure Node.js. No network, no AI, no extra cost.