代理板
Agentboard 是网络用户界面 tmuxclaude Code 和 Codex 等运行编码代理设备。 在桌面或服务器上启动您的代理, 然后从任何浏览器, 包括您的手机, 监视并引导他们 .
每个会话都生活在tmux中,所以关闭分页时你的代理继续运行,每个设备都有同样的会话可用.
同样的tmux会话在笔记本电脑和手机上.
特征
每届会议的现状和最后一次提示每个会话都显示从其终端输出中推断的状态: 正在工作, (中文(简体) ), 等待输入,或 需要许可。与代理记录匹配的会话还显示您发送的最后一个提示。 可选声音告诉您何时需要会话许可或闲置 . |
|
分剂活性对于本地Claude Code和Codex会话,会话的计数器显示有多少子代理正在运行. 点击它可以看到主会话和每个子剂及其当前状态和最后一个活性信号的时间. |
|
用 CI 状态拉请求拉动创建会话的请求 |
|
记录的媒体一个媒体铁路收集图像、文件和会议记录的链接。 在取景器中打开任意图像,并步入其余部分. |
|
历史 休伯纳特 醒来休眠状态 关闭代理会话的 tmux 窗口, 并将其对话保留在侧边栏中 。 它在 Agentboard 管理的 tmux 会话中为本地会话工作. 历史 列出最近的对话:打开一个来预览其记录,然后 醒来 继续. |
|
在你的电话上在小屏幕上,棋盘切换为触摸布局:会话抽屉,快键工具栏(Esc, Tab, Ctrl,箭头键,数字)和粘贴对话框. 触摸滚动,自来相击,以及终端的长压选择工作. 在你的家用屏幕上加入板作为PWA.
|
|
其他机器的会话来自其他机器的会话在SSH上方的同一块板上出现,每块上都有一个主机徽章. 通过主机或项目过滤板. 见 远程主机。 。 。 . |
|
还有
- 浏览器中的完整终端. 鼠标滚动,选择,剪贴板与克洛德代码的全屏幕渲染器一起工作.
- 粘贴或将文本、图像和文件放入提示中.
- 键盘快捷键来切换,创建并关闭会话.
- 按年龄或需要注意的内容排序, 按项目或主机过滤, 或将会话拖入您的顺序 .
- 会话恢复列出崩溃或重启中断的会话, 这样您就可以重新打开 。 自动重开是选入 。 见 会话恢复。 。 。 .
支助代理人
| 探员 | 匹配, 最后一个提示, Wake | 调取请求 | 媒体铁路 | 分剂活性 |
|---|---|---|---|---|
| 克劳德代码 | 对 | 对 | 对 | 对 |
| 代码 | 对 | 对 | 对 | 对 |
| Pi | 对 | 对 | 链接 | |
| 哦,我的宝贝 | 对 | 对 | 链接 | |
| 开发CLI | 对 | 对 | 链接 | |
| 格罗克CLI | 对 | 对 | 链接 |
媒体铁路显示克劳德代码和Codex的图像,文件和链接. 对于其他特工来说,它显示了链接.
Agentboard在其默认位置找到每个代理的笔录,并自动与tmux窗口相匹配. 在tmux中运行的任何其他程序也作为平版终端会话工作,具有状态但无笔录功能.
所需资源
- macOS(苹果硅或英特尔)或Linux(x64或arm64).
- tmux 3.2 或以后的:
brew install tmux或者说apt install tmux。 。 。 . - 撕裂 (单位:千美元)
rg:brew install ripgrep或者说apt install ripgrep. Agentboard 使用它来匹配代理文本到 tmux 窗口. Homebrew 和 npm 包不安装它 . - 分级 (推荐)或您机器的另一条网络路径,用于从其他设备访问.
可选 :
安装
土生土长
brew tap gbasin/tap
brew install agentboard
agentboard
无
需要节点.js 18或以后.
npm install -g @gbasin/agentboard
agentboard
或运行它而不安装:
npx @gbasin/agentboard
打开棋盘
打开 http://localhost:4040 在同一个机器上.
如果 Tailscale 正在运行, Agentboard 也会在您的 Tailscale 地址上监听 。 打开 http://<your-machine>:4040 从任何设备 在你的尾网。 要在手机的屏幕上安装板子,看 PWA 安装。 。 。 .
没有尾图, Agentboard 只能接受同一机器的连接. 要改变这一点,看 网络和安全。 。 。 .
运行它作为服务
登录时启动代理板并保持其运行 :
- 马可斯: 发射/README.md
- 林纳: 系统/README.md
两个安装器都需要对这个寄存器进行git检出. 他们不使用Homebrew或npm安装.
升级
运行 brew upgrade agentboard 或者说 npm install -g @gbasin/agentboard@latest,然后重新启动代理板。 您的 tmux 会话会一直贯穿重启, 您的数据会留在 ~/.agentboard。 。 。 .
这些命令不升级安装在已启动或系统安装器上的服务. 按照服务指南的规定升级服务.
卸载
停止代理板,然后运行 brew uninstall agentboard 或者说 npm uninstall -g @gbasin/agentboard。 。 。 .
brew uninstall 如果没有其他公式需要,也删除 tmux。 要保持tmux,运行 HOMEBREW_NO_AUTOREMOVE=1 brew uninstall agentboard。 。 。 .
如果您安装了服务, 请先移除它 。 关于这一点,以及一个未安装的数据和设置,见 卸载。 。 。 .
从源
见 发展。 。 。 .
配置
Agentboard 配置了环境变量 。 它没有指挥线的旗帜.
PORT=8080 TMUX_SESSION=work agentboard
| 变量 | 默认 | 效果 |
|---|---|---|
PORT | 4040 | 网络用户界面端口 . |
HOSTNAME | 127.0.0.1 | 要装订地址 设定 0.0.0.0 以在所有界面上监听. |
TMUX_SESSION | agentboard | Agentboard 管理的 tmux 会话名称 . |
DISCOVER_PREFIXES | 未设定 | 限制您其他 tmux 会话中的哪个出现在棋盘上 。 默认情况下,它们全部出现. |
AGENTBOARD_REMOTE_HOSTS | 未设定 | SSH主机在板上显示. |
AGENTBOARD_DATA_DIR | ~/.agentboard | 数据库和日志目录 . |
见 配置 每个环境.
外观、通知声音、命令预设、会话列表选项和终端选项都在 设置 用户界面中的对话 .
安全说明: 代理板没有认证 。 任何能够到达服务器的人都可以作为您的用户运行命令. 默认它接受来自此机器的连接,如果Tailscale正在运行,则接受来自您的尾网的连接. 未设置
HOSTNAME=0.0.0.0在您不信任的网络(公共Wi-Fi,共享局域网)上,没有另一个访问控制层。 见 警卫 完全威胁模型.
键盘快捷键
| 行动 | 麦克 | 视窗/ Linux |
|---|---|---|
| 上届会议 | Ctrl+Option+[ | Ctrl+Shift+[ |
| 下届会议 | Ctrl+Option+] | Ctrl+Shift+] |
| 跳转到会话 1- 9 | Ctrl+Option+1..9 | Ctrl+Shift+1..9 |
| 新会话 | Ctrl+Option+N | Ctrl+Shift+N |
| 杀死会话 | Ctrl+Option+X | Ctrl+Shift+X |
| 设置 | Ctrl+Option+, | Ctrl+Shift+, |
要使用不同的修饰符, 打开 设置 > 翻译: 终端。 。 。 .
如何运作
┌─────────────┐ SSH ┌─────────────┐
│ Remote Host ├───────────►│ │ WebSocket ┌────────────┐
│ (tmux) │ │ Agentboard ├──────────────►│ Browser │
└─────────────┘ tmux │ Server │ │ (React + │
┌─────────────┐ CLI │ │ │ xterm.js) │
│ Local tmux ├───────────►│ - discover │ └────────────┘
│ sessions │ │ sessions │
└─────────────┘ │ - parse │
┌─────────────┐ read │ agent │
│ Agent logs ├───────────►│ logs │
│ │ └─────────────┘
└─────────────┘
- 会话发现: 服务器对本地 tmux 窗口进行民调,如果配置的话,远程主机会覆盖 SSH .
- 状态推断 : 服务器读取窗格内容, 以显示每个代理商是否 正在工作, (中文(简体) ), 等待输入,或 请求许可。 。 。 .
- 日志匹配 : 服务器读取代理记录稿,将每个会话与它的tmux窗口相匹配,并显示其最后的快取,拉取请求和媒体.
- 现场终端 : 服务器流终端 I/O 到浏览器, 这样您就可以使用任何设备的会话 .
- 休眠和历史会议: 侧边栏保持休眠 代理会话, 当你需要它时,你醒来一个。 启动不会唤醒休眠或历史会话.