token-savior

List all registered workspace projects with their index status.

Switch the active project. Subsequent tool calls without explicit project target this project.

Return a structured git status summary for the active project: branch, ahead/behind, staged, unstaged, and untracked files.

Return a compact symbol-oriented summary of current worktree changes, avoiding large textual diffs.

Return a compact symbol-oriented summary of git changes since a given ref, avoiding large textual diffs.

Summarize a set of changed files as symbol-level entries for compact review instead of textual diffs.

Build a compact commit/review summary from changed files using symbol-level structure instead of textual diffs.

Create a compact checkpoint for a bounded set of files before a workflow mutation.

List available checkpoints for the active project.

Delete a specific checkpoint.

Keep only the newest N checkpoints and delete older ones.

Restore files from a previously created checkpoint.

Compare a checkpoint against current files at symbol level, returning added/removed/changed symbols without a textual diff.

Replace an indexed symbol's full source block directly, without sending a file-wide patch.

Insert content immediately before or after an indexed symbol, avoiding a file-wide edit payload.

Infer a compact set of likely impacted pytest files from changed files or symbols.

Run only the inferred impacted pytest files and return a compact summary instead of full logs.

Replace a symbol, reindex the file, and run only the inferred impacted tests as one compact workflow.

Replace a symbol, validate impacted tests, and restore the previous file automatically if validation fails.

Detect conventional project actions from build files (tests, lint, build, run) without executing them.

Run a previously discovered project action by id with bounded output and timeout.

High-level overview of the project: file count, packages, top classes/functions.

List indexed files. Optional glob pattern to filter (e.g. '.py', 'src/**/.ts').

Structure summary for a file (functions, classes, imports, line counts) or the whole project if no file specified.

Get the full source code of a function or method by name. Uses the symbol table to locate the file automatically.

Get the full source code of a class by name. Uses the symbol table to locate the file automatically.

List all functions (with name, lines, params, file). Filter to a specific file or get all project functions.

List all classes (with name, lines, methods, bases, file). Filter to a specific file or get all project classes.

List all imports (with module, names, line). Filter to a specific file or get all project imports.

Find where a symbol (function, method, class) is defined. Returns file path, line range, type, signature, and a source preview (~20 lines).

What does this symbol call/use? Returns list of symbols referenced by the named function or class.

What calls/uses this symbol? Returns list of symbols that reference the named function or class.

Analyze the impact of changing a symbol. Returns direct dependents and transitive (cascading) dependents.

Find the shortest dependency path between two symbols (BFS through the dependency graph).

All-in-one context for editing a symbol. Returns the symbol source, its direct dependencies (what it calls), and its callers (who uses it) in a single response. Saves 3 separate tool calls.

List files that this file imports from (file-level import graph).

List files that import from this file (reverse import graph).

Regex search across all indexed files. Returns up to 100 matches with file, line number, and content.

Re-index the entire project. Use after making significant file changes to refresh the structural index.

Add a new project root to the workspace and switch to it. Triggers a full reindex of the new root. After calling this, all other tools operate on the new project by default.

Find all files related to a feature keyword, then trace imports to build the complete feature map. Example: get_feature_files('contrat') returns all routes, components, lib, types connected to contracts. Each file is classified by role.

Session efficiency stats: tool calls, characters returned vs total source, estimated token savings.

Detect all API routes and pages in a Next.js App Router project. Returns route path, file, HTTP methods, and type (api/page/layout).

Cross-reference an environment variable across all code, .env files, and workflow configs. Shows where it's defined, read, and written.

Detect React components in .tsx/.jsx files. Identifies pages, layouts, and named components by convention (uppercase name or default export).

Analyze config files for issues: duplicate keys, hardcoded secrets, and orphan entries. Checks can be filtered via the 'checks' parameter.

Find unreferenced functions and classes in the codebase. Detects symbols with zero callers, excluding entry points (main, tests, route handlers, etc.).

Rank functions by complexity score (line count, branching, nesting depth, parameter count). Helps identify code that needs refactoring.

Detect breaking API changes between the current code and a git ref. Finds removed functions, removed parameters, added required parameters, and signature changes.

Detect dependencies between indexed projects. Shows which projects import packages from other indexed projects and shared external dependencies.

Analyze Dockerfiles in the project: base images, stages, exposed ports, ENV/ARG vars, and cross-reference with config files. Flags issues like 'latest' tags and missing env vars.