Skip to content

Repository files navigation

TokenWar

TokenWar logo

TokenWar token-saving stack

CI

Seven complementary token-saving tools plus a shared project-memory layer. TokenWar reduces shell output, heavy context, repeated memory, provider payloads, verbose responses, oversized code, and repository exploration. OpenWiki adds a durable wiki that lets an entire team reuse the cost of understanding a project.

Documentation menu

Page Use it for
Install Default behavior, --all, optional flags, verification
Project memory Graphify + OpenWiki, team workflow, CI, costs and refresh policy
Tool map What each tool saves and when to use it
Savings Why the lanes stack and how gains are measured honestly
Commands Status, gain, doctor, providers and maintenance
Local scan Log audit, recommendations and break-even method
Copilot GitHub Copilot CLI wiring

Quick start

Install everything, including Graphify and OpenWiki:

curl -fsSL https://raw.githubusercontent.com/oratelecom/tokenwar/main/install.sh | bash -s -- --all
source ~/.bashrc
tokenwar status
tokenwar check
tokenwar gain

A bare install is intentionally non-invasive: it installs TokenWar and its shell integration, but none of the managed tools. See installation modes.

The stack

Tool Lane
caveman Compact model responses
RTK Compress shell and tool output
context-mode Keep heavy data outside the context window
claude-mem Preserve personal cross-session memory
pxpipe Reduce provider-bound prompt payloads
Graphify Query repository structure instead of repeatedly sweeping files
ponytail Produce smaller code that stays cheaper to read
OpenWiki Create shared, versioned project memory for the whole team

OpenWiki is deliberately shown separately from the seven live compression lanes. It spends tokens to synthesize grounded Markdown, then amortizes that cost across developers, agents, providers, sessions, onboarding, reviews and incidents.

claude-mem = what my agent learned
OpenWiki   = what the team knows about the project

Recommended project routine

Inside every active, long-lived repository:

graphify .             # initial structural graph
openwiki --init        # initial grounded project wiki (uses an LLM)

graphify update .      # after code changes; AST update needs no LLM
openwiki --update      # after merges; clean no-op uses no LLM

For teams, commit the OpenWiki output and run updates in CI so one generation is shared by everyone. Details and a CI pattern are in Project memory.

Commands

tokenwar status
tokenwar test
tokenwar check
tokenwar gain
tokenwar doctor
tokenwar scan
tokenwar upgrade

TokenWar never fabricates savings. Native telemetry is reported where available; otherwise the result is N/A or an explicitly labelled estimate.

License

MIT — © 2026 Ora Telecom.

About

6-tool token-saving stack for Claude Code (caveman + RTK + context-mode + claude-mem + ponytail + pxpipe) — also wraps Codex, Gemini, Kimi & opencode

Resources

Stars

61 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages