tokensave_affectedLABSCO SUMMARY
Trades an index build for the file-scanning an agent would otherwise redo every session.
tokensave_context is the call that replaces a round of exploration: entry points, related symbols and snippets arrive together instead of after a dozen greps. Branch-aware queries matter more than they sound on a repository with long-lived branches, since "who calls this" has a different answer depending on where you are standing. Worth knowing before you install — setup writes agent configuration and, for one client, hooks that block exploratory sub-agents and redirect symbol-shaped greps into these tools.
What it is
A Rust binary that indexes a repository into a local symbol graph and answers structural questions about it — what calls what, what breaks if you change this, where the complexity sits — in single calls rather than a round of file reads.
What you get
- tokensave_context — entry points, related symbols and code snippets for a task, gathered in one call instead of a dozen searches
- Navigate the graph — tokensave_callers, tokensave_callees, tokensave_affected for blast radius, and tokensave_annotations
- Search across the index rather than across files, with results that know what a symbol is rather than only where the text matched
- Branch-aware queries — tokensave_branch_list, tokensave_branch_diff and tokensave_branch_search, so a question can be asked about the branch you are on
- Three build tiers chosen at install: the default covers more than fifty languages, medium and lite trade coverage for a smaller binary
- Tokensave install writes the MCP configuration for the agent you name — Claude Code, Codex, Cursor, Copilot, Gemini CLI, Cline, OpenCode, Kiro, Kimi, Antigravity, AugmentCode, Factory Droid, Kilo and Pi — or auto-detects what is on the machine
Requirements
A local checkout to index. Everything runs on your machine with no service behind it and no account. Install with brew, scoop, or cargo install tokensave — cargo also takes feature flags for the medium and lite tiers — or take a prebuilt bundle from the releases for macOS, Linux or Windows, each published with a checksum. Registration writes agent configuration and, for one client, hooks as well.
Setup effort
One command — brew install aovestdipaperino/tap/tokensave
USE CASES
Starting work in a codebase you do not know
Ask for the context around the task and get entry points, related symbols and snippets together.
Working out what a change would break
Read the blast radius from the graph rather than searching for the symbol's name.
Tracing what a function actually does
Follow its callees down instead of opening each file in turn.
Reviewing what a branch changed
Diff it structurally and search within it, rather than reading the raw patch.
Cutting how much context exploration costs
Install it for the agent you already use and let symbol-shaped searches go to the index.
58 tools
Listed in project docs. Your client may show a different list.
tokensave_ambiguous_callstokensave_annotationstokensave_ast_grep_rewritetokensave_branch_difftokensave_branch_listtokensave_branch_searchtokensave_calleestokensave_callerstokensave_changelogtokensave_circulartokensave_commit_contexttokensave_complexitytokensave_contexttokensave_couplingtokensave_dead_codetokensave_dependenciestokensave_dependency_depthtokensave_diff_contexttokensave_distributiontokensave_doctokensave_doc_coveragetokensave_dsmtokensave_filestokensave_ginitokensave_god_classtokensave_healthtokensave_hotspotstokensave_impacttokensave_importstokensave_inheritance_depthtokensave_insert_attokensave_largesttokensave_module_apitokensave_multi_str_replacetokensave_nodetokensave_port_ordertokensave_port_statustokensave_pr_contexttokensave_ranktokensave_record_code_areatokensave_record_decisiontokensave_recursiontokensave_redundancytokensave_rename_previewtokensave_searchtokensave_session_endtokensave_session_recalltokensave_session_starttokensave_similartokensave_simplify_scantokensave_statustokensave_str_replacetokensave_test_coveragetokensave_test_maptokensave_test_risktokensave_type_hierarchytokensave_unused_importsBEFORE YOU INSTALL
What to know first
Tools you get
58 tools named in the project's documentation.
INSTALLATION
Connect your client
Server setup
Install the binary — macOS: brew install aovestdipaperino/tap/tokensave; Windows: scoop bucket add tokensave https://github.com/aovestdipaperino/scoop-bucket && scoop install tokensave; any platform: cargo install tokensave (add --features medium or --no-default-features for smaller builds); or download a prebuilt archive from the latest release and put it on PATH
Register it with your agent: tokensave install (auto-detects) — or tokensave install --agent claude|cursor|codex|gemini|zed|opencode|cline|copilot|kiro|… ; add --local for project-scoped config instead of global
Index the project:
cd <YOUR_PATH_TO_PROJECT> && tokensave initKeep it fresh with tokensave sync (incremental); global git post-commit/post-checkout hooks can do this automatically (--git-hook yes)
MCP Clients
All detected clients
tokensave installClaude Code
{
"mcpServers": {
"tokensave": {
"command": "<YOUR_PATH_TO_TOKENSAVE>",
"args": [
"serve"
]
}
}
}Cursor
tokensave install --agent cursorCodex
tokensave install --agent codexGitHub Copilot
tokensave install --agent copilotGemini CLI
tokensave install --agent geminiAntigravity
tokensave install --agent antigravityAugment Code
tokensave install --agent auggieCline
tokensave install --agent clineFactory Droid
tokensave install --agent droidKilo CLI
tokensave install --agent kiloKiro
tokensave install --agent kiroKimi CLI
tokensave install --agent kimiOpenCode
tokensave install --agent opencodePi
tokensave install --agent piPlank
tokensave install --agent plankQwen Code
tokensave install --agent qwenRoo Code
tokensave install --agent roo-codeMistral Vibe
tokensave install --agent vibeZed
tokensave install --agent zedGrok Build
tokensave install --agent grok