Render subagent-cli child agent TUIs (Claude Code, Codex, Gemini CLI, etc.) inside VS Code terminal tabs instead of a browser viewer.
Requirements
Requires the @yejianfei.billy/subagent-cli CLI, version 0.1.18 or newer. Older versions lack the IPC handshake this extension depends on; the status bar shows a warning until a compatible CLI is found.
npm i -g @yejianfei.billy/subagent-cli
Settings
| Setting | Default | Purpose |
|---|---|---|
subagent-cli.daemon.port |
7100 |
Authoritative port the extension passes to subagent-cli daemon start --port. |
subagent-cli.cli.path |
"" |
Absolute path to the subagent-cli executable. Leave empty to look it up on PATH. When set, the directory is prepended to PATH in every new VS Code terminal, so plain subagent-cli resolves to this build (and overrides any globally installed copy). Reopen terminals to apply changes. |
subagent-cli.viewer.browser |
external |
How to open the Subagent viewer when the status bar button is clicked: external (system browser) or internal (VS Code webview). |
subagent-cli.terminal.location |
panel |
Where subagent session terminals open: panel (terminal panel) or editor (editor/document tab area). |
Development
- Install dependencies and build:
npm install npm run build - Open this folder in VS Code and press
F5to launch an Extension Development Host. - Ensure the
subagent-cliCLI is available onPATH(or setsubagent-cli.cli.pathto point at a custom build). - In a terminal inside the dev host, run
subagent-cli open -s claude(or any subagent your config defines).
Scripts
npm run build # webpack production bundle → dist/extension.js
npm run watch # webpack --watch for iterative dev
npm run package # build a universal .vsix
npm run publish # package + publish to VS Code Marketplace and Open VSX
Platform support
The extension itself is cross-platform (Unix Socket on Linux/macOS, Named Pipe on Windows). End-to-end availability follows the subagent-cli main package builds.
License
Apache-2.0