v1.5.0 Engine
Precision engineered features.
TokenCap transforms how you capture, snapshot, and optimize code for LLMs. Built for local-first speed, self-maintaining MCP intelligence, and developer ergonomics.
history
Version Release Highlights
Full evolutionary path and changelog items for TokenCap CLI.
v1.5.0
July 19, 2026Self-Maintaining MCP Intelligence
- Automatic Initialization — MCP startup automatically runs
tokencap makebefore tool execution, eliminating manual pre-build steps. - Live Repository Watcher — MCP server process maintains a live background watcher for source edits and
.tokencap-notes.mdupdates. - Universal Host Setup —
tokencap mcp --initsupports Claude Code, Cursor, Windsurf, Cline, VS Code, Antigravity, and Codex. - Explicit Client Selector — Use
tokencap mcp --init --client <host>when workspaces contain multiple AI clients. - Safer Configuration Merging — Merges TokenCap definitions safely into existing host configs without replacing unrelated servers.
- Durable Metadata — Stores detected tech stack in
knowledge.jsonfor offline MCP overview rendering. - Zero-Latency Caching — In-memory cached tool calls process in 0–2 ms handler duration.
v1.4.0
July 15, 2026Repository Intelligence Service & Security Hardening
- Repository Intelligence Service — Query repository intelligence live over local stdio Model Context Protocol (MCP).
- 11 Tool Endpoints —
tokencap_overview,tokencap_files,tokencap_search,tokencap_cluster,tokencap_dependencies,tokencap_constitution,tokencap_impact,tokencap_execution,tokencap_verify,tokencap_delta, andtokencap_mcp_status. - Security Hardening Engine — Centralized secret redaction guarantees no API keys, tokens, or credentials survive into intelligence outputs.
- Up to 92% Token Savings — Replaces massive 20,000 token cold-loads with targeted 1,500 token queries on demand.
v1.3.0
July 10, 2026Incremental Intelligence Engine
- Incremental Intelligence Engine —
tokencap makenow rebuilds only what changed. SHA-256 hash comparison, bidirectional dependency BFS, and per-cluster selective rebuilds replace full-scan defaults. - SHA-256 Hash Cache —
.tokencap/cache/hashes.cache.jsonstores file hashes with integrity checksum. Corrupted or missing cache triggers automatic full rebuild fallback. - Impact Analysis — Changed files are mapped to affected clusters via
knowledge.json, propagated to dependent clusters one level deep. If >60% clusters are affected, a full rebuild is triggered instead. - Selective Rebuild — Graph patches only dirty nodes and prunes ghost edges. Brain updates only affected clusters. Constitution re-evaluates only impacted rules via
getImpactedRules(). Agent files update only sections referencing affected clusters. - Delta Files — After every build,
.tokencap/delta/writeschanged-files.json,affected-clusters.json,dirty-nodes.json, and per-engine delta JSON files. AI agents consume only what changed. - Versioned Delta History —
.tokencap/delta/history/stores timestamped delta snapshots (last 10 by default) for rollback and audit. - New CLI Flags —
--full(force full rebuild),--rebuild-brain,--rebuild-constitution,--rebuild-graph,--clean-cache. Default is now incremental. - Zero-Change Detection — If nothing changed,
tokencap makeexits in sub-100ms with no disk writes. "Intelligence is up to date."
save
Auto Capture on Save
Sync your context instantly. TokenCap monitors file saves and automatically updates snapshot files in the background.
[10:42:01] Saved: page.tsx
[10:42:04] Regenerating files...history
Git-Aware Snapshots
Prioritize active edits. Surfaces unstaged/staged diffs and ranks recently changed files higher in LLM snapshots.
BRANCHfeature/auth
Prioritizing changed files...
hub
Local MCP Service
Query repository intelligence live over stdio MCP (11 tool endpoints) with automatic startup init and background watching.
$ tokencap mcp --init
Status: Active (0-2ms latency)
11 MCP Tool Endpoints
bolt
Incremental Engine
Analyze once. Update only what changed. Uses SHA-256 caching and dependency walks for sub-100ms updates.
⚡ Incremental Build
Duration: 74ms
Selective Rebuild: Clean
menu_book
Repository Constitution
Define permanent guidelines that AI agents must never violate (API contracts, database schema rules, security laws, compliance). Includes health scoring index.
$ tokencap constitution
Constitution Score: 92/100
✔ Inferred 14 API laws
🛡 2 IMMUTABLE rules active
verified_user
Local-first Privacy
Your code never leaves your machine. Processing happens entirely on-device for maximum security.
home
lock
account_tree
Interactive Graph Viewer
Map out dependencies with Cytoscape.js (`--open`), generate narrative architecture summaries (`--ai`), and track structural changes (`--diff`).
BUILDING GRAPH...
package_2
AI Context Packing
Token-budgeted, importance-scored context compression. Prioritizes critical files and truncates others using AST analysis.
Token Budget:20,000
AST compression & git ranking
difference
AI Change Intelligence
Deterministic risk rating and semantic layering. Scans for breaking changes and maps endpoint additions or modifications.
Risk Level:HIGH
API routes modified: 3
Breaking changes: Yes
Breaking changes: Yes
Start capturing context.
Get Started Free
npm install -g tokencap