✨ 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

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

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:

🛠️ 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.