DimAgent for VS Code
Launch the dimcode AI agent TUI directly inside VS Code.
Features
- 🖥 Open TUI — One-click terminal with
npx dimcode in a split editor pane
- 📄 VS Code focus — Runtime focus context is delivered to matching TUI instances
- ▶ One-shot prompt — Run
dim exec with editor context auto-appended
- 🔧 CLI command runner — Quick access to auth, sessions, providers, MCP
Requirements
- Node.js and npm available in the VS Code host environment
- VS Code 1.87+
Quick Start
- Install the extension
- Click the DimAgent icon in the editor toolbar (top-right) or activity bar
- The dim TUI opens in a split pane next to your code
Usage
| Action |
How |
| Open TUI |
Click toolbar icon, or Cmd+Shift+P → DimAgent: Open TUI |
| Open with context |
DimAgent: Open TUI with Context — opens TUI and pushes current focus context after launch |
| Run prompt |
DimAgent: Run Prompt — auto-includes active file and selected code |
| CLI commands |
DimAgent: Run CLI Command — quick pick for auth, sessions, providers, MCP |
Keyboard Shortcuts
| Shortcut |
Command |
Cmd+Shift+Alt+D |
Open TUI |
Cmd+Shift+Alt+E |
Open TUI with Context |
Configuration
| Setting |
Type |
Default |
Description |
dimagent.cli.launchMode |
"npx" or "path" |
npx |
Launcher mode |
dimagent.cli.npxPackage |
string |
dimcode |
Package used by npx mode |
dimagent.cli.path |
string |
dim |
CLI path used by path mode |
dimagent.cli.defaultArgs |
string[] |
[] |
Extra CLI arguments |
How It Works
The extension spawns npx dimcode in a VS Code terminal placed in the editor area via ViewColumn.Beside. Each launch receives:
- Workspace root → terminal
cwd
- VS Code window id →
--vscode-window-id
- Launch id →
--vscode-launch-id
For Run Prompt, file path and selection are prepended to the prompt text sent to dim exec.
| |
