# Reported issues for TokenSave

Pod holds 5 of 5 GitHub reports that passed its relevance review. This can include external user reports, maintainer-confirmed bugs, and concrete feature gaps. Treat them as evidence to inspect, not a count of distinct defects.

Back to [TokenSave](/mcp/tokensave).

## Most discussed

### The rules file `install` writes never names `tokensave_read`, and agents route every other tool but that one

# The rules file `install` writes never names `tokensave_read`, and agents route every other tool but that one

**tokensave 7.11.1** · Windows 11 · Claude Code · 18 indexed projects on one machine

## Summary

`~/.claude/rules/tokensave.md` — the instruction file tokensave's Claude
integration writes — lists the navigation tools and omits `tokensave_read`:

> Before reading source files or scanning a codebase, use the tokensave MCP
> tools: `tokensave_context` for exploration,…

[Read the thread](https://github.com/aovestdipaperino/tokensave/issues/540) · 2026-09-12 · closed · outside contributor · 2 comments

### Pre-dispatch resync can hang an MCP call past the client timeout, and the stderr log names the wrong tool

### tokensave version

7.11.0

### Operating system

macOS

### Installation method

Built from source

### What happened?

A `tokensave_search` call over MCP (stdio) never produced a response and the client gave up after its 30s deadline. The client's error carried tokensave's stderr tail, and the last line there was the *previous* call:

```
mcp call failed: no response within 30s: [tokensave] tool call: tokensave_read
```

That is the diagnostic point: `eprintln!("[tokensave] tool call:…

[Read the thread](https://github.com/aovestdipaperino/tokensave/issues/535) · 2026-09-11 · closed · 2 comments

### MCP edit/read tools index files outside the served project under their absolute path

**Version:** 7.11.1, Linux.

**What happens.** A `tokensave serve` for project A, handed an absolute `path` to a file in another project B, indexes that file into A's graph under its absolute path. A's `files` table then carries `/.../B/...` rows, and A's `tokensave_context` / `tokensave_largest` answer with B's symbols.

**Repro** (verified):

1. `git init` + `tokensave init` in `/tmp/ts-a` (`a.go`) and `/tmp/ts-b` (`b.go`).
2. `tokensave serve` in `/tmp/ts-a`; `tools/call`…

[Read the thread](https://github.com/aovestdipaperino/tokensave/issues/528) · 2026-09-11 · closed · external user · 1 comment

### MCP tool results repeatedly prepend the one-hour index-age warning and can trigger agent retries

### tokensave version

7.11.0

### Operating system

macOS

### Installation method

Built from source

### What happened?

When an MCP server's `last_sync_at` is more than one hour old, `McpServer::handle_tools_call` inserts `WARNING: Index last synced ... Run `tokensave sync` to update.` as the first text item in every successful local tool result. The outer JSON-RPC response remains valid, but the warning is mixed into the tool's content stream as if it were part of the answer. In agent…

[Read the thread](https://github.com/aovestdipaperino/tokensave/issues/516) · 2026-09-08 · closed · 1 comment

### Index and retrieve OpenTofu/Terraform dependency lockfiles

### tokensave version

7.11.1

### Operating system

macOS (also affects Linux and Windows)

### Installation method

Built from source

### What happened?

Tokensave indexes Terraform/OpenTofu HCL configuration such as `versions.tf` (#497), but it skips `.terraform.lock.hcl`, the dependency lockfile both tools write under the same basename. `tokensave sync` reports the lockfile as an unsupported `.hcl` file, and `tokensave_files` does not return it.

This leaves an important infrastructure…

[Read the thread](https://github.com/aovestdipaperino/tokensave/issues/520) · 2026-09-08 · closed · 0 comments

## Most recent

The remaining reports are on [the project's issue tracker](https://github.com/aovestdipaperino/tokensave/issues).