
Demo GIF 待补
为多角色 / 多任务的 Claude Code 用户管理并发会话,每组共享初始提示词,开箱即用。
三个杀手锏
- 按"角色"分组的 Claude 会话 — 不是一堆乱终端,而是按 PM / DEV / QA / 任意角色组织的树视图。
- 每组的初始提示词自动注入 — 建分组时填一次(多行 markdown),组内所有新窗口启动时自动注入。
- 关 tab 不杀进程,重开就接回原会话 — PTY 后台常驻,编辑器 tab 只是视图;关闭再打开,完整 buffer 回放,进程不中断。
完整功能列表
(点击展开)
- Groups → Windows 树视图(Activity Bar 入口)
- 组级 初始 prompt(多行 markdown)spawn 时自动注入
- 实时 token + cost 徽章(Opus 4.7 / Sonnet 4.6 / Haiku 4.5 费率)
- Reattach 到存活 PTY — 关 tab 重开不丢会话
- 状态机: dormant / running / idle / error / closed,prompt 检测 + 5s 静默 fallback
- Session 绑定: 检测新
~/.claude/projects/*.jsonl文件并绑定到 spawn 出的窗口,重启后 resume 可用 - 拖拽 跨组移动 / 组内重排
- 行内按钮: 窗口行 open / rename / close 三个图标,分组行新建窗口图标
- 窗口级操作: Restart / Copy Session ID / Open Session Log / Inject Group Prompt
- Preflight: 提醒
claude不在 PATH 或node-pty加载失败 - Resume retry:
--resume <id>3s 内退出会自动 fresh 重启 - IME 输入支持: webview 终端兼容中文 / 日文 / 韩文输入法 composition
Requirements
- VS Code 1.100+
claudeCLI on your PATH (or setclaudeWindows.claudeCommandto an absolute path)- macOS, Linux, or Windows (PTY backed by
node-pty)
Settings
| key | default | meaning |
|---|---|---|
claudeWindows.defaultArgs |
[] |
args passed to every spawn |
claudeWindows.claudeCommand |
claude |
binary path or command name |
claudeWindows.shell |
auto |
auto / zsh / bash / powershell |
claudeWindows.initialPromptDelay |
2000 |
ms before injecting the group prompt |
claudeWindows.killTimeoutMs |
3000 |
SIGTERM → SIGKILL window on close |
claudeWindows.tokenWatchEnabled |
true |
watch ~/.claude/projects/ for usage |
claudeWindows.defaultNamePrefix |
Window |
prefix for auto-generated names |
Commands
All commands are prefixed Claude Windows: in the palette.
New Window,Open Window,Rename Window,Close Window,Move Window to GroupRestart Window,Copy Session ID,Open Session Log,Inject Group PromptNew Group,Rename Group,Edit Group Prompt,Delete Group,Move Group Up/DownRefresh,Show Output Log
Build / Develop
npm install
npm run build # esbuild dual bundle: extension.cjs + webview.iife
npm run test:unit # data-layer suites (no electron)
npm run test # unit + integration via @vscode/test-electron
npm run package # produces a .vsix via vsce
Press F5 in VS Code to launch the extension host.
Known Limitations
- Linux + fcitx IME: Chinese / CJK input via fcitx may still race with xterm's helper textarea on some distros. macOS Pinyin and Windows IME have been validated; fcitx feedback is welcome.
License
MIT