Omarchy Plugin
把 Busabase 放进 Omarchy 顶栏：看到你和 Agent 今天留下了什么，连同历史打开每条变更，并把 Busabase 技能链接到你的 Agent。
Omarchy 的插件都在它的顶栏里。Busabase 插件会在顶栏放上 Busabase 图标：统计你和 Agent 今天在 Busabase 留下了几条，每落下一条就闪一下 +1，点开面板还能用大白话看到每条变更。插件开源（MIT），源码在 github.com/busabase/omarchy-busabase。
1. 安装插件
在 Omarchy 的终端里运行：
omarchy plugin add https://github.com/busabase/omarchy-busabase.git --enableBusabase 图标会出现在顶栏右侧。图标变暗表示还没有连接。
2. 登录
点击图标，再点 Sign in to Busabase。Omarchy 的浮动终端会打开 busabase-cli login。选择 Busabase Cloud、自托管服务器或本机上的 Busabase；如有提示，在浏览器里确认那串短码。
已经用 busabase-cli 登录过？
不用再做什么。小组件读取的就是 busabase-cli login 写入的同一个 ~/.busabase/.env。如果 localhost:15419 上有 Busabase 服务器响应，面板里还会出现 Use Busabase on this computer。
3. 教会 Agent 使用 Busabase
打开 Teach my agents Busabase。它会把内置的 Busabase 技能链接到 Claude Code、Codex、Pi 和 ~/.agents/skills。已经打开的 Agent 需要重启才能加载技能。关掉开关，链接就会移除。
4. 让 Agent 存点东西
对 Agent 说，例如：「把这周的竞品笔记存到 Busabase。」 变更落下时，数字会闪一下 +1，然后停在新的总数上。
看懂面板
- 每一行说明留下了什么，以 Agent 客户端或它所用 API 密钥的名字称呼，例如 「Codex added 1 record to Bugs · 5m ago」。
- 在某一行上按 Enter，会在 Busabase 中打开它，可以看完整历史并撤回。
- 只有当你的某个变更在等审核时（密钥只能提议变更，或数据表要求审核），图标上才会出现强调色小圆点。
| 按键 | 作用 |
|---|---|
j / k、方向键 | 移动 |
Enter | 打开选中的行 |
r | 刷新 |
o | 打开 Busabase |
Esc | 关闭 |
想用快捷键开关面板，可以绑定 omarchy-shell busabase toggle。
它读什么、写什么、发什么
- 读取
~/.busabase/.env。API 密钥从不出现在命令行里。 - 网络：只向你的 Busabase 服务器发
GET请求，默认每 60 秒一次；未连接时额外探测一次localhost:15419。 - 写入：只有你选择 Use Busabase on this computer 时才写
~/.busabase/.env，只有打开技能开关时才创建技能软链接。它从不覆盖你自己安装的技能。
卸载
先关掉 Teach my agents Busabase，再运行：
omarchy plugin remove busabase你的 Busabase 数据和 ~/.busabase/.env 都不受影响。