Reai Vibe Board

ReAI Vibe Board · Claude Code 联动插件

让 K203 键盘的拨杆模式指示与你终端里运行的原生 Claude Code（用你自己的订阅）保持一致。

它做什么

插件注册了四个 hook（UserPromptSubmit / PreToolUse / PostToolUse / SessionEnd）。 用户提交提示和工具调用前后，hook 脚本 write-mode.sh 从 Claude Code 传入的 JSON 里取出当前会话的 session_id / cwd / transcript_path / permission_mode，原子写入到桌面 App 约定的状态文件：

macOS: ~/Library/Application Support/reai-vibe-board/cc-mode.json

桌面 App 读取这个文件来校正拨杆当前指示的模式（例如你手动 Shift+Tab 切了模式、 或批准了 plan 模式后，App 能从这里读到真实的 permission_mode 并对齐）。 会话结束时，SessionEnd hook 会用 clear-mode.sh 只清理同一 session_id 的文件， 避免已结束会话被 App 当作仍然新鲜的校准来源，也避免误清理其他活跃会话。

滞后说明：Claude Code 目前没有「模式切换专属回调」，hook 只在提示提交和工具调用边界触发， 所以 permission_mode 相对实际切换仍可能有滞后。App 注入 Shift+Tab 来驱动 Claude Code 自己的模式循环，因此不要禁用 Claude Code 的 Shift+Tab 模式切换快捷键。

安装

本插件没有 marketplace 包，按本地 plugin 目录加载（不要用 claude plugin install reai-vibe-board@reai 这类 marketplace 命令）。

从 App 设置页加载

打开桌面 App 的 Claude Code 联动设置页，点击复制安装流程。App 会把本插件和本地 marketplace 准备到应用数据目录，并给出可直接在 Claude Code 里按顺序执行的命令， 例如：

/plugin marketplace add "/Users/<you>/Library/Application Support/reai-vibe-board/plugins"
/plugin install reai-vibe-board@reai-vibe-board-local
/reload-plugins

不同 Claude Code 版本的本地加载语法可能不同（/plugin 菜单 / 本地路径参数）； 以你本机 /plugin 的提示为准。插件 manifest 在 .claude-plugin/plugin.json， hook 定义在 hooks/hooks.json。

开发仓库本地加载

贡献者在开发仓库里也可以直接加载本目录：

/plugin marketplace add .
/plugin install reai-vibe-board@reai-vibe-board-local
/reload-plugins

开发仓库根目录需有 .claude-plugin/marketplace.json 才能用上面的相对路径流程； 面向普通用户请使用 App 设置页复制出来的绝对路径流程。

JSON 解析依赖

Hook 脚本优先使用 node 解析 stdin JSON；如果没有 node，会 fallback 到 jq。 两者都不可用时脚本会静默退出，不会阻断 Claude Code 的 hook 链。通常 Claude Code 运行环境已经有 node，无需额外安装。

验证

启动一个会调用工具的 Claude Code 会话后，检查状态文件是否生成：

cat "$HOME/Library/Application Support/reai-vibe-board/cc-mode.json"

应能看到 permission_mode、session_id、cwd、updated_at 等字段。 会话结束后，该文件应被 SessionEnd hook 删除。

Shift+Tab 要保持启用

拨杆切模式的底层动作是向前台终端注入 Shift+Tab。不要在 Claude Code keybindings 里禁用 chat:cycleMode / confirm:cycleMode 对应的 Shift+Tab 绑定；禁用后手按和 App 注入都会失效。