Trace for Code

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.