Skip to content

Releases: itsarmaanverma/local-token-saver

v0.1.0 — Local Token Saver MVP

Choose a tag to compare

@itsarmaanverma itsarmaanverma released this 09 Jul 23:39

Local Token Saver — MVP release

Locally installed, folder-scoped retrieval-first context for Claude Code and Codex.

Highlights

  • Hybrid retrieval: SQLite FTS5 (BM25) + hashed-TF vector cosine, budgeted evidence packs instead of full-file reads
  • Automatic PDF pipeline: script-based (no LLM) PDF → Markdown → vectorizer conversion with cached mirrors, page-cited results
  • MCP server: hand-rolled stdio JSON-RPC server exposing 9 tools; one-line installers for Claude (.mcp.json) and Codex (~/.codex/config.toml)
  • Security defaults: secrets never indexed (.env*, *.pem, *.key, credentials/secrets files), evidence-not-instructions wrapper, no telemetry, no remote upload
  • Zero external runtime deps beyond pypdf; token-saver setup auto-installs what's missing

Quality

  • 20/20 unit tests passing (ignore matching, config merging, PDF pipeline, MCP arg coercion, incremental indexing, vector sanity)
  • Full multi-agent code review completed — 8 findings identified and fixed prior to this release

Install

pip install git+https://github.com/itsarmaanverma/local-token-saver.git
token-saver setup
token-saver mcp install . --claude --protocol

See README for full setup instructions.