Start
Install TCalc and run your first workspace scan
Install the VS Code extension, scan a local workspace, and understand the first set of token and model results.
A local dashboard with workspace totals, heavy paths, and three goal-aware model recommendations.
Before you begin
- Visual Studio Code 1.85 or newer
- A folder or workspace you can open locally
Install the extension
Install TCalc from the VS Code Marketplace or Open VSX. The extension includes its model catalog, so a workspace does not need catalogs/models.json or .tcalc/models.json for the first scan.
If you downloaded a release artifact instead, install the VSIX from the Extensions view or with the command below. Replace the wildcard with the file you downloaded when your shell does not expand it.
code --install-extension dist-vsix/tcalc-0.1.4.vsixRun Quick Start
- Open the code workspace you want to measure.
- Open the Command Palette and run TCalc: Quick Start.
- Choose the goal that best matches the work, such as debugging, refactoring, documentation, or security review.
- Review the dashboard after the local scan completes.
Read the results
Included tokens are the estimated context after ignore rules and safety exclusions. Top files and folders show where a smaller repo map or another exclusion can save the most context. Warnings identify generated, oversized, or risky paths without copying their contents into a remote service.
The model section is a ranked catalogue, not a single hard-coded winner. Cheapest sufficient favors cost after meeting the task threshold, balanced trades quality against cost and latency, and high confidence favors capability. Change the goal, privacy mode, or context selection when only one model fits.