@gbasin/agentboard

中文文档
0.46.8发布于 2026/11/15MITES Module构建来源已验证近 30 天下载 7293

Tmux 的 Web GUI 优化用于 AI 代理 TUI

中文使用文档
文档目录23 节
  1. 特征
  2. 每届会议的现状和最后一次提示
  3. 分剂活性
  4. 用 CI 状态拉请求
  5. 记录的媒体
  6. 历史 休伯纳特 醒来
  7. 在你的电话上
  8. 其他机器的会话
  9. 还有
  10. 支助代理人
  11. 所需资源
  12. 安装
  13. 土生土长
  14. 无
  15. 打开棋盘
  16. 运行它作为服务
  17. 升级
  18. 卸载
  19. 从源
  20. 配置
  21. 键盘快捷键
  22. 如何运作
  23. 文档

代理板

CI npm License: MIT TypeScript Ask DeepWiki

Agentboard 是网络用户界面 tmuxclaude Code 和 Codex 等运行编码代理设备。 在桌面或服务器上启动您的代理, 然后从任何浏览器, 包括您的手机, 监视并引导他们 .

每个会话都生活在tmux中,所以关闭分页时你的代理继续运行,每个设备都有同样的会话可用.

Agentboard in a desktop browser window, with a phone in front of it. The desktop sidebar lists agent sessions with their status, age, last prompt and pull request chips; one session waits for permission. The terminal shows a Claude Code session refactoring a router, with a Media 2 pill in its corner. The phone shows the same session's terminal with a quick-keys toolbar.

同样的tmux会话在笔记本电脑和手机上.

特征

每届会议的现状和最后一次提示

每个会话都显示从其终端输出中推断的状态: 正在工作, (中文(简体) ), 等待输入,或 需要许可。与代理记录匹配的会话还显示您发送的最后一个提示。 可选声音告诉您何时需要会话许可或闲置 .

Animation: the sidebar lists sessions with their last prompts and ages. The selected session, orders-migration, shows a permission prompt to run a database migration; its status badge changes to a raised hand while the prompt is open, then back to now when the prompt is answered.

分剂活性

对于本地Claude Code和Codex会话,会话的计数器显示有多少子代理正在运行. 点击它可以看到主会话和每个子剂及其当前状态和最后一个活性信号的时间.

The agent activity panel for the router-refactor session, opened from its subagent counter showing 3. The main session has an active model turn. Of four subagents, Migrate billing routes and Run e2e suite are waiting on Edit and Bash tool calls, Migrate invoice routes has an active model turn, and Audit auth middleware has finished.

用 CI 状态拉请求

拉动创建会话的请求 gh pr create 或通过 GitHub 连接器作为芯片出现在会话上,颜色按状态:开口,草稿,合并,或关闭. Claude Code会话还显示Claude Code与会话相关的拉动请求,比如它所推动的拉拉请求. 找一个芯片看看它的标题和CI检查.

Four sidebar sessions with pull request chips: a draft (489), two open (482 and 1193) and a merged one (1187). A hover card for pull request 1193 shows its title and four CI checks, one of them failing.

记录的媒体

一个媒体铁路收集图像、文件和会议记录的链接。 在取景器中打开任意图像,并步入其余部分.

The media rail open over a session's terminal: tabs for Media 5 and Links 1, then thumbnails for a PDF report, a search results screenshot, a CPU flame graph and two latency charts. Below it, the transcript lines where the agent read those files.

历史 休伯纳特 醒来

休眠状态 关闭代理会话的 tmux 窗口, 并将其对话保留在侧边栏中 。 它在 Agentboard 管理的 tmux 会话中为本地会话工作. 历史 列出最近的对话:打开一个来预览其记录,然后 醒来 继续.

The transcript preview of a past Claude Code conversation, admin-react-19, about upgrading an app to React 19, with Cancel and Wake buttons.

在你的电话上

在小屏幕上,棋盘切换为触摸布局:会话抽屉,快键工具栏(Esc, Tab, Ctrl,箭头键,数字)和粘贴对话框. 触摸滚动,自来相击,以及终端的长压选择工作. 在你的家用屏幕上加入板作为PWA.

Three phone screens. Left: the session drawer listing sessions with status, last prompt and pull request chips. Middle: a session waiting on a permission prompt, with a row of numbered session tiles at the top and the quick-keys toolbar at the bottom. Right: the paste dialog with three lines of text ready to submit.

其他机器的会话

来自其他机器的会话在SSH上方的同一块板上出现,每块上都有一个主机徽章. 通过主机或项目过滤板. 见 远程主机。 。 。 .

Five sidebar sessions from two machines: rows badged STUDIO run locally, rows badged BUILD-BOX run on a remote host. The remote Codex session nightly-e2e is selected.

还有

  • 浏览器中的完整终端. 鼠标滚动,选择,剪贴板与克洛德代码的全屏幕渲染器一起工作.
  • 粘贴或将文本、图像和文件放入提示中.
  • 键盘快捷键来切换,创建并关闭会话.
  • 按年龄或需要注意的内容排序, 按项目或主机过滤, 或将会话拖入您的顺序 .
  • 会话恢复列出崩溃或重启中断的会话, 这样您就可以重新打开 。 自动重开是选入 。 见 会话恢复。 。 。 .

支助代理人

探员匹配, 最后一个提示, 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 包不安装它 .
  • 分级 (推荐)或您机器的另一条网络路径,用于从其他设备访问.

可选 :

  • 这个 GitHub 缩写 (单位:千美元)gh),以显示拉动请求状态和CI检查.
  • ssh 基于密钥的访问,以显示来自 远程主机。 。 。 .

安装

土生土长

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 只能接受同一机器的连接. 要改变这一点,看 网络和安全。 。 。 .

运行它作为服务

登录时启动代理板并保持其运行 :

两个安装器都需要对这个寄存器进行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
变量默认效果
PORT4040网络用户界面端口 .
HOSTNAME127.0.0.1要装订地址 设定 0.0.0.0 以在所有界面上监听.
TMUX_SESSIONagentboardAgentboard 管理的 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- 9Ctrl+Option+1..9Ctrl+Shift+1..9
新会话Ctrl+Option+NCtrl+Shift+N
杀死会话Ctrl+Option+XCtrl+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 到浏览器, 这样您就可以使用任何设备的会话 .
  • 休眠和历史会议: 侧边栏保持休眠 代理会话, 当你需要它时,你醒来一个。 启动不会唤醒休眠或历史会话.

文档

版本与发布记录

@gbasin/agentboard 共发布 198 个版本,首次发布于 2026/02/07;过去 12 个月发布了 198 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.46.8latest2026/11/151 天前
0.46.72026/11/142 天前
0.46.62026/11/132 天前
0.46.52026/11/132 天前
0.46.42026/11/133 天前
0.46.32026/11/133 天前

关于 @gbasin/agentboard 的常见问题

@gbasin/agentboard 是什么?

Tmux 的 Web GUI 优化用于 AI 代理 TUI

如何安装 @gbasin/agentboard?

在项目目录运行 npm install @gbasin/agentboard,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agentboard,可以用 npx agentboard 直接运行。

@gbasin/agentboard 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/gbasin__agentboard 是否存在。

@gbasin/agentboard 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@gbasin/agentboard 可以商用吗?

@gbasin/agentboard 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gbasin/agentboard 的下载量有多少?

根据 npm 官方下载统计,@gbasin/agentboard 在 2026/10/16 – 2026/11/14 这 30 天内被下载 7,293 次,日均约 243 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gbasin/agentboard 还在维护吗?

最新版本 0.46.8 发布于 2026/11/15(1 天前);至今共发布 198 个版本,其中过去 12 个月发布了 198 个;首次发布于 2026/02/07。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。