TCalc

Scan a codebase once. See where its context goes, which model is enough for the job, and what your coding agent should read first.
Everything runs locally: no telemetry, cloud calls, or source upload.

Install · See it work · CLI · Coding agents · Website

See the workspace before your agent does

TCalc respects workspace ignore rules, estimates tokens by file, folder, and language, then recommends models against the actual context and your current goal.

Compare models against the scan	Generate a budgeted repo map

One scan, three useful decisions

The scanner, recommender, report generator, and integrations share the same local-first core. Model catalogs stay provider-neutral, and recommendations change with the task rather than hard-coding one model as “best.”

Start in VS Code

Install TCalc from the VS Code Marketplace or Open VSX, then run:

Command Palette → TCalc: Quick Start

The guided flow scans the open workspace, sets a goal, compares models, and opens the dashboard. You can also install a downloaded release directly:

code --install-extension tcalc-*.vsix

See the VSIX installation guide for the local package workflow. A source-built JetBrains plugin is also available as an MVP for IntelliJ-based IDEs.

Use the CLI

Build once, then scan, compare, or generate only the context you need:

pnpm install
pnpm build

pnpm cli scan ./my-project
pnpm cli recommend ./my-project --goal build-mvp
pnpm cli repo-map ./my-project --budget 8000
pnpm cli rules ./my-project --target codex --mode repo-map-first

Other commands generate Markdown/JSON reports, validate model catalogs, create MCP configs, and start the local MCP server. Run pnpm cli --help for the complete command list.

Connect your coding agent

TCalc can expose the same scan, recommendation, repo-map, rules, and report capabilities over stdio MCP. It also generates agent rule files and client configuration without uploading source code.

# Generate a client config
pnpm cli mcp-config --target cursor
pnpm cli mcp-config --target continue --output continue-mcp.yaml

# Start the experimental local server
pnpm cli mcp

[!NOTE]
The MCP server is an experimental MVP: stdio transport only, with no hosted mode. Repo maps are structural and do not expose full source file bodies. See the MCP documentation for tools, resources, prompts, security boundaries, and current limits.

Repository map

Project guides

Troubleshooting VS Code test output

• Missing catalogs/models.json or .tcalc/models.json files are optional workspace overrides; TCalc uses the catalogue bundled with the extension when neither exists.

• Messages that reference embeddings.vscode-cdn.net come from VS Code/Copilot semantic tooling, not TCalc. Update VS Code and Copilot, then run Developer: Reload Window. TCalc does not fetch remote embeddings. VS Code documents both its CDN network endpoint and that embedding-backed features require connectivity.

• Configuration schema

• Coding-agent integrations

• CI reporter

• Release checklist

• Contributing

• Security policy

License

MIT