by cytostack
Sharper context. Fewer tokens. Open-source middleware for Claude Code.
# Add to your Claude Code skills
git clone https://github.com/cytostack/openwolfClaude Code is powerful but it works blind. It doesn't know what a file contains until it opens it. It can't tell a 50-token config from a 2,000-token module. It reads the same file multiple times in one session without noticing. It has no index of your project, no memory of your corrections, and no awareness of what it already tried.
OpenWolf gives Claude a second brain: a file index so it knows what files contain before reading them, a learning memory that accumulates your preferences and past mistakes, and a token ledger that tracks everything. All through 6 invisible hook scripts that fire on every Claude action.
Tested on a large active project. Same codebase, same prompts, different setups:
OpenClaw + Claude ██████████████████████████████████████ ~3.4M tokens
Claude CLI (no OpenWolf) ████████████████████████████████ ~2.5M tokens
OpenWolf + Claude CLI ████████ ~425K tokens
OpenWolf saved ~80% of tokens compared to bare Claude CLI on the same project.
Across 20 projects, 132+ sessions: average token reduction of 65.8%, with 71% of repeated file reads caught and blocked. These are numbers from real usage, not benchmarks. Your results will vary by project size and usage patterns.
npm install -g openwolf
cd your-project
openwolf init
That's it. Use claude normally. OpenWolf is watching.
openwolf init creates a .wolf/ directory in your project:
| File | Purpose |
|------|---------|
| anatomy.md | Project file map with descriptions and token estimates |
| cerebrum.md | Learned preferences, corrections, Do-Not-Repeat list |
| memory.md | Chronological action log with token estimates |
| buglog.json | Bug fix memory, searchable, prevents re-discovery |
| token-ledger.json | Lifetime token tracking and session history |
| hooks/ | 6 Claude Code lifecycle hooks (pure Node.js) |
| config.json | Configuration with sensible defaults |
| identity.md | Agent persona for this project |
| OPENWOLF.md | Instructions Claude follows every session |
Before Claude reads a file, OpenWolf tells it what the file contains and how large it is. If Claude already read that...
No comments yet. Be the first to share your thoughts!