cytostack/openwolf

Portable project memory across Claude Code, Codex and OpenCode, plus token accounting measured from harness transcripts. Local file I/O, no API calls, no telemetry.

What it solves

Coding agents often waste tokens by re-reading the same files multiple times, dumping massive amounts of bash output into the context window, or losing project-specific knowledge and conventions when switching between different AI agents or starting new sessions. OpenWolf provides a shared, durable memory layer that persists across different tools and prevents redundant token usage.

How it works

OpenWolf installs lifecycle hooks (Node.js scripts) into supported coding agents. It creates a .wolf/ directory in the project root to act as a "brain" containing a project index, bug logs, and session handoffs.

Key mechanisms include:

  • Bash Governor: Condenses oversized bash output (over 2,000 tokens) before it enters the agent's context, while keeping the full text on disk.
  • Durable Indexing: Uses a project index to allow agents to locate symbols and read specific line ranges rather than entire files.
  • Context Restoration: Re-injects rules and state after context compaction or session starts to prevent the agent from "forgetting" instructions.
  • Measurement: Scans transcripts to report actual token usage and verify savings.

Who it’s for

Developers using AI coding agents like Claude Code, Codex CLI, OpenCode, Cursor, or Gemini CLI who want to reduce token costs and maintain a consistent project memory across different tools.

Highlights

  • Cross-Agent Memory: Shared project state (conventions, bug fixes) that persists across different AI tools.
  • Token Optimization: Reduces context bloat by condensing bash output and providing targeted file reads.
  • Verified Reporting: A dashboard and reporting tool that measures real usage from transcripts rather than using heuristics.
  • Local-First: Pure local file I/O with no API calls or telemetry.
  • Integrated Skills: Includes built-in commands for project handoffs, security audits, and UI framework migration.

Related

  • Project
  • Project
  • Project
  • Project
  • Dispatch