# TokenSave

Builds a local semantic code graph so AI agents query symbols in libSQL instead of reading whole files. Useful when repo scans consume too many tokens.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 677
- Author: aovestdipaperino
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aovestdipaperino/tokensave
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/tokensave

## What it does

Instead of scanning directories with `grep` and file reads, TokenSave maintains a semantic graph of the codebase in a local libSQL database with FTS5 search. An agent queries MCP tools to inspect symbols and resolve caller relationships in a single call. Over 50 languages are supported, including Rust and TypeScript.

Code parsing runs in isolated subprocesses. A parser crash on an invalid file terminates only that worker pool process, allowing repository indexing to continue. Alongside graph traversal, the tool tracks code health metrics and executes anchored file edits.

Everything runs locally on your machine. No external services or API keys are required.

## Requirements
- Needs: a prebuilt binary from the repository releases

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- query code symbols and entry points through a local semantic graph
- trace callers and callees to analyze modification impact
- reduce token spend when exploring large codebases
- inspect code health metrics and structural complexity

## Example prompts
- Find all callers of `validateToken` using the TokenSave graph
- Build task context and trace dependencies for the auth module
- Inspect repository health metrics to identify structural risks

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md