VS Code Extension
The contextd VS Code extension provides a visual interface for managing your project’s context directly from the editor.
Installation
Install from the VS Code Marketplace.
The extension activates automatically when a .context/project.md file exists in your workspace, or when you run any contextd command.
Features
Context Tree View
A dedicated sidebar view (contextd.contextTree) showing all your context files organized into sections:
- Core —
project.md,architecture.md,conventions.md(expanded by default) - Decisions — All ADRs with
ADR-XXXlabels - Modules — Module context files grouped by scope
Click any file to open and edit it directly. Stale or unfilled files are marked with a warning icon.
Health Dashboard
A webview panel (contextd.healthView) showing:
- Health Score (0–100%): color-coded green (≥80%), yellow (≥50%), or red (<50%)
- Statistics: passed checks, warnings, errors, total files
- Checks List: all health checks with status icons
Status Bar Indicator
Shows contextd in the status bar when initialized. Click it to run a health check.
Commands
| Command | Title | Description |
|---|---|---|
contextd.init | Initialize in this project | Scaffold .context/ directory with templates |
contextd.export | Export context | Export to CLAUDE.md, .cursorrules, or copy raw output to clipboard |
contextd.check | Check context health | Run a health check and show results in the Health Dashboard |
contextd.addDecision | Add architecture decision (ADR) | Create a new ADR with a pre-filled template |
contextd.addModuleContext | Add module context for current file | Create module context scoped to the current file’s directory |
contextd.copyContextForFile | Copy relevant context to clipboard | Copy all context relevant to the active file |
contextd.refreshTree | Refresh | Refresh the context tree and health views |
Editor Context Menu
Right-click any file in the editor to access:
- contextd: Copy relevant context to clipboard — copies context relevant to that file
- contextd: Add module context for current file — creates a module context scoped to that file’s directory
Auto-Export
Enable contextd.autoExportOnSave in your settings to automatically regenerate CLAUDE.md or .cursorrules whenever a context file is saved.
Settings
| Setting | Type | Default | Description |
|---|---|---|---|
contextd.defaultExportFormat | string | claude-md | Default format for exports (claude-md, cursorrules, raw) |
contextd.autoExportOnSave | boolean | false | Auto-regenerate export files on context file save |
contextd.showStatusBar | boolean | true | Show the status bar indicator |
File Watching
The extension watches .context/**/*.md for changes and automatically refreshes the tree and health views when files are created, modified, or deleted. On file creation, it also triggers auto-export if enabled.