CodeIsland VS Code Bridge

将 VS Code 中 Claude Code 的活动状态实时转发到 CodeIsland macOS 刘海面板。

为什么需要这个扩展？

CodeIsland 通过 hooks 监控 AI 编程工具状态，但 Claude Code VS Code 扩展中 hooks 不会触发（已知限制）。本扩展通过监控 Claude Code 的 session/transcript 文件来桥接这个缺口。

工作原理

Claude Code VS Code Extension
  → 写入 ~/.claude/ session/lock/transcript 文件
    → CodeIsland VS Code Bridge（轮询这些文件）
      → Unix socket → /tmp/codeisland-<uid>.sock
        → CodeIsland app → 刘海面板更新

安装

从 VSIX 安装

1. 从 Releases 下载最新 .vsix 文件
2. 运行 code --install-extension codeisland-vscode-0.1.0.vsix

从源码构建

git clone https://github.com/caiyuze-cpu/codeisland-vscode.git
cd codeisland-vscode
npm install
npm run compile
npx vsce package --allow-missing-repository
code --install-extension codeisland-vscode-0.1.0.vsix

使用

1. 启动 CodeIsland app
2. 打开 VS Code，扩展自动激活
3. 使用 Claude Code 扩展
4. 观察 CodeIsland 刘海面板显示状态

配置

设置	默认值	说明
codeisland.socketPath	自动检测	CodeIsland Unix socket 路径
codeisland.pollInterval	500	Transcript 轮询间隔(ms)
codeisland.debug	false	启用调试日志

事件映射

Claude Code 活动	CodeIsland 事件
会话开始	SessionStart
用户发送 prompt	UserPromptSubmit
工具调用开始	PreToolUse
工具调用完成	PostToolUse
AI 回复完成	Stop
会话结束	SessionEnd

要求

• macOS 14+ (Sonoma)
• CodeIsland app 正在运行
• VS Code 1.94+
• Claude Code VS Code Extension (anthropic.claude-code)

License

MIT