toksave

Zero-config toolchain for token-efficient AI coding agents.

One command to install and wire token-saving tools into 9 AI coding agents. No config editing. No manual setup. Just run, restart, go.

✨ Why toksave?

AI coding agents are powerful, but they burn tokens on verbose output, redundant context, and missing guardrails. The fix exists — RTK, Caveman, CodeGraph, Context-Mode, Ponytail, and Principles each solve one piece. The hard part is installing and wiring all of them across multiple agents without breaking configs.

toksave handles the wiring so you can focus on the code.

	Benefit
✔️	Plug & play — one command equips all your agents
✔️	Idempotent — safe to rerun, never duplicates configs
✔️	Clean revert — uninstall removes exactly what it added
✔️	Cross-platform — macOS, Linux, Windows
✔️	Health checks — `toksave doctor --fix` repairs broken installs
✔️	Auto-index — CodeGraph index builds on agent startup

🤖️ Supported Agents

Claude Code _{✅ Supported}	OpenCode _{✅ Supported}	Codex _{✅ Supported}	Antigravity _{✅ Supported}
GitHub Copilot _{✅ Supported}	Droid _{✅ Supported}	Devin / Cascade _{✅ Supported}	Warp / Oz _{✅ Desktop + Agent CLI}
Cursor CLI _{✅ Supported}

toksave                                      # interactive: pick agents
toksave --agents claude,opencode             # wire specific agents
toksave --agents claude,opencode,antigravity # or any combination

📦 What Gets Installed

Tools

Tool	Stars	Description
RTK		CLI proxy that compresses tool output — 60-90% token savings
Caveman		Terse response mode — ~75% output token reduction
CodeGraph		Pre-indexed code knowledge graph — fewer MCP calls
Context-Mode		MCP sandbox with session memory — 98% context compression
Ponytail		Lazy-coding discipline — YAGNI, stdlib first, delete over add
Principles		Coding standards — think, simplify, edit surgically

Wiring Matrix

Plain-text table (for screen readers)

Tool	Claude	OpenCode	Codex	Antigravity	Copilot	Droid	Devin	Warp	Cursor
RTK	Hook + Allow	Plugin	Hook	Hook + Allow	Hook + Allow	Hook	Hook	Hook	Hook + Allow
Caveman	Plugin + Instr.	Plugin + Instr.	Skill + Instr.	Skill + Instr.	Skill + Instr.	Skill + Instr.	Skill + Instr.	Skill + Instr.	Skill + Instr.
Ponytail	Plugin + Instr.	Plugin + Instr.	Plugin + Instr.	Plugin + Instr.	Skill + Instr.	Skill + Instr.	Skill + Instr.	Skill + Instr.	Skill + Instr.
CodeGraph	MCP + Allow + Instr.	MCP + Auto-index	MCP + Instr.	MCP + Hook + Instr.	MCP + Hook + Instr.	MCP + Hook + Instr.	MCP + Instr.	MCP + Instr.	MCP + Instr.
Context-Mode	MCP + Allow + Instr.	Plugin + Instr.	MCP + Hook + Instr.	MCP + Instr.	MCP + Hook + Instr.	MCP + Instr.	MCP + Instr.	MCP + Instr.	MCP + Instr.
Principles	Instr.	Instr.	Instr.	Instr.	Instr.	Instr.	Instr.	Instr.	Instr.

Regenerate the heatmap after editing the matrix: python3 scripts/generate_wiring_heatmap.py

🚀 Getting Started

Prerequisites

Node.js ≥ 22 (required by CodeGraph and Context-Mode)
At least one supported agent installed

Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/agungprasastia/toksave/main/scripts/install.sh | bash

Windows:

irm https://raw.githubusercontent.com/agungprasastia/toksave/main/scripts/install.ps1 | iex

Quick start

toksave                    # detects agents, installs tools, wires everything
# restart your agent, you're done

Commands

Command	Description
`toksave`	Install + wire all tools into detected agents
`toksave doctor`	Health check with repair suggestions
`toksave doctor --fix`	Repair unhealthy tool installations
`toksave update`	Update all tools to latest versions
`toksave uninstall`	Remove toksave wiring from all agents
`toksave disable`	Remove all wire/unwire + owner entries
`toksave index`	Pre-build CodeGraph index in current directory
`toksave self-update`	Update the toksave CLI itself

Flags

Flag	Description
`-a, --agents <ids>`	Target agents (e.g., `claude,antigravity`)
`-t, --tools <ids>`	Target tools (e.g., `rtk,caveman`)
`-n, --dry-run`	Preview changes without writing
`-y, --yes`	Skip prompts, auto-select (CI-friendly)
`-v, --verbose`	Detailed logs

Tip: Restart your agent after running toksave so it picks up the new configuration.

📚 Documentation

For in-depth guides, architecture specifications, and troubleshooting:

CLI & Command Reference — Complete breakdown of commands, flags, environment variables, and exit codes.
Agent & Tool Matrix — Technical reference on agent file locations, hooks, plugins, and instruction block formats.
Architecture & Stability — Core design principles, smart config pruning, and E2E test verification results.
Troubleshooting & FAQ — Common solutions for Windows PATHEXT, Node.js versions, and rate limits.

🛠️ Development

Built with Rust.

git clone https://github.com/agungprasastia/toksave.git
cd toksave

cargo run -- --help        # Run CLI in dev mode
cargo check                # Compiler check
cargo test                 # Unit & integration tests
cargo clippy               # Linter check
cargo fmt --check          # Code formatting check
cargo build --release      # Local release binary

📜 License

MIT — see CHANGELOG.md for release history.