TRACE for VS Code is a TypeScript extension scaffold that connects VS Code to the TRACE API wrapper. It is designed as the frontend layer for the TRACE repository engine and focuses on source control UX rather than reimplementing backend logic.
Features
Detects TRACE repositories by looking for .trace/HEAD in the workspace.
Shows TRACE state in the status bar.
Surfaces TRACE staged, changes, deleted, and untracked groups in the SCM view.
Opens built-in VS Code diffs for staged and working changes.
Provides commands for refresh, status, stage, unstage, reset, commit, branch creation, branch checkout, and commit browsing.
Configuration
This extension contributes the following settings:
traceForVsCode.apiBaseUrl: Base URL for the TRACE API wrapper. Default: http://127.0.0.1:8080
traceForVsCode.requestTimeoutMs: API request timeout in milliseconds. Default: 5000
Requirements
VS Code 1.120.0 or newer.
The TRACE API wrapper running locally and reachable from the extension.
A workspace containing a TRACE repository initialized with .trace/.
Commands
TRACE: Refresh Status
TRACE: Show Detailed Status
TRACE: Stage File
TRACE: Unstage File
TRACE: Reset Staging
TRACE: Commit
TRACE: Create Branch
TRACE: Checkout Branch
TRACE: Show Commits
TRACE: Open File Diff
Development
Install dependencies and run the extension build:
npm install
npm run compile
Open the folder in VS Code and use the Run and Debug view to launch the extension host.
The SCM input box can be used to commit directly, and the resource context menus expose stage, unstage, and diff actions.
Notes
The API base URL is configurable so the extension can point at a separately running TRACE backend.
This scaffold is intentionally lightweight and can later be split into its own repository without structural changes.
