vibepanel 多代理开发控制台
在一个自托管网页中管理跨项目并行运行的编码代理会话。
- Star 数
- ★ 29
- 最近更新
- 5 天前
- License
- NOASSERTION
- 主语言
- Go
- FA 评分
- 85/100 · 表现良好
30 秒速览
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 开始前需要
- 典型场景
- 同时在多个代码库中运行 Claude Code、Codex 或其他终端编码代理的开发者，用统一侧栏查看每个会话是在工作、等待还是已经退出。
- 主要局限
- 当前许可证为带署名条件的 PolyForm Noncommercial 1.0.0；公司内部使用、托管服务或产品捆绑等商业用途需要另行取得许可。
- 源码审查
- 85/100 · 表现良好
这个 Agent 能做什么，适合哪些场景？
vibepanel 是面向多项目、多编码代理工作流的自托管 Web 控制台，以项目和会话为核心组织终端。终端进程由独立系统服务和 tmux 保持运行，浏览器负责命名、排序、状态展示和交互，因此关闭页面或重启面板不会结束会话。它提供桌面与手机界面、文件管理器、笔记本、临时终端、令牌用量和主机负载视图，并可通过同一套 API 自动创建和控制会话。Telegram、飞书和个人微信集成可将权限请求或问题送到私聊，并把回复传回指定会话。项目以单个 Go 二进制自托管，可自行终止 TLS，并支持密码或 passkey 登录；适合希望从多种设备管理长期运行代理的开发者。
用户先把开发目录登记为项目，再从 Web 界面或 POST /api/sessions 创建会话；command 字段是 argv，省略时会启动 shell。后端通过独立服务与 tmux 维持终端和代理进程，网页可同时显示各项目会话处于工作、等待或已结束状态。侧栏可管理文件和笔记，支持通过复制粘贴移入或移出文件与图片；底部 scratch terminal 可在不中断代理的情况下检查文件或运行命令。内置 hook 可安装到 Claude Code、Codex、Kimi Code、zcode 或 opencode，用于识别代理真正完成或正在等待操作的状态，并在写入前展示内容和备份文件。可选聊天集成会把会话编号、问题或权限请求发送至 Telegram、飞书或微信，用户可以回复指定会话；Telegram 和飞书还提供 Allow、Deny 按钮。它也能发布由项目中的代理编写的共享页面，通过链接在手机、电脑、电视或状态屏上展示。
- 同时在多个代码库中运行 Claude Code、Codex 或其他终端编码代理的开发者，用统一侧栏查看每个会话是在工作、等待还是已经退出。
- 把开发主机留在办公室或家中的个人开发者，通过手机界面继续查看终端，并处理代理提出的问题或权限请求。
- 需要全天运行长期任务的团队或个人，依靠 tmux 和独立终端服务让会话在浏览器关闭、面板升级或应用层崩溃后继续存在。
- 希望把代理操作纳入脚本或内部系统的工程团队，通过 Bearer Token 和 /api/sessions 等 API 创建和管理会话。
- 需要向团队或现场屏幕展示会话状态、令牌消耗或项目页面的用户，通过可发布的共享页面和全屏预览生成展示链接。
如何安装或部署这个 Agent？
交互式安装器适用于 Linux 和 macOS：
curl -fsSL https://raw.githubusercontent.com/jiangmuran/vibepanel/main/install.sh | sh网络受限时可使用项目作者运营的 GitHub 镜像；首次运行会要求在浏览器中完成检查：
curl -fsSL https://github.muran.tech/https://raw.githubusercontent.com/jiangmuran/vibepanel/main/install.sh -o vibepanel-install.sh \|| curl -sSL https://github.muran.tech/https://raw.githubusercontent.com/jiangmuran/vibepanel/main/install.sh
sh vibepanel-install.sh --mirror安装后可用以下命令管理服务：
vibepanel service status
vibepanel service start
vibepanel service stop
vibepanel service restart
vibepanel service logs
vibepanel service token
vibepanel service upgrade
vibepanel service uninstall安装器支持用户级或系统级服务、无人值守安装、命令行创建首个账户、Docker 和源码构建，但所给材料没有列出这些方式的完整参数。
如何使用这个 Agent？
启动服务后，在浏览器中打开面板，完成首个账户配置并添加项目，然后从项目中创建终端或代理会话。面板自身创建普通 shell 时会省略 command；要运行代理，可将对应可执行程序作为 command argv。程序化调用需要先在“Settings → API tokens”创建令牌，然后执行：
TOKEN=…
curl -sX POST https://panel.example.com:18443/api/sessions \
-H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
-d '{"projectId":"…","title":"billing","command":["claude"]}'把 panel.example.com、projectId 和 TOKEN 替换为实际值。管理员 CLI 还提供 serve、project、session、hook、service、account、doctor 和 version 子命令。若需远程聊天处理请求，可在设置中配置并显式启用 Telegram、飞书或微信渠道；启用前聊天功能不会连接外部服务。
这个 Agent 有哪些优点和局限？
- 终端状态不依附浏览器页面；tmux 与独立系统服务可让运行中的会话跨页面关闭、面板升级和应用层重启继续存在。
- 同一界面整合多项目会话、移动端终端、文件管理、笔记、临时终端、令牌统计和机器负载，减少在多个终端窗口间切换。
- 明确支持 Claude Code、Codex、Kimi Code、zcode 和 opencode 的完成状态 hook，而不只用终端静默来猜测任务是否结束。
- 提供 Bearer Token API，并声称前端能力均通过同一 API 暴露，便于接入自动化流程。
- 单个 Go 二进制可自行处理 TLS、密码与 passkey；聊天集成在未配置和启用前不会连接外部服务。
- 当前许可证为带署名条件的 PolyForm Noncommercial 1.0.0；公司内部使用、托管服务或产品捆绑等商业用途需要另行取得许可。
- 核心会话持久化依赖 tmux，采用其他终端复用器或不具备相同运行环境时需要调整部署方式。
- 交互式安装器只明确支持 Linux 和 macOS；所给材料没有证明 Windows 可直接安装。
- 远程聊天功能会引入 Telegram、飞书或微信服务器的数据传输，并要求用户首次启用时接受相应边界。
- 项目自称仍处于早期阶段，采用者需要预期功能和运维行为仍可能演进。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|
| vibepanel 多代理开发控制台 当前 | 85 · 表现良好 | ★ 29 | 5 天前 | Go | Codex · Claude Code |
| Happier | 82 · 表现良好 | ★ 1.7k | 今天 | TypeScript | Codex · Claude Code |
| Agent Session Manager 桌面版 | 67 · 存在缺口 | ★ 18 | 1 天前 | Go | Codex · Claude Code |
| Collie | 84 · 表现良好 | ★ 1.1k | 今天 | TypeScript | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示 CI 使用只读 contents 权限，发布物由公开工作流构建并校验 SHA256；聊天渠道默认关闭，首次启用会披露数据流并等待同意，陌生用户需配对，远程批准绑定到具体请求。源码还说明钩子写入前预览并备份。扣分在于产品本质上可启动终端、写文件、暴露远程入口，安装路径包含 curl 管道执行；所给材料未完整说明令牌、密码、聊天凭据的静态存储、加密、轮换和日志脱敏，也未说明升级交换后的自动回退。作者、仓库和归属条款明确，因此来源归属满分；发布者未验证只视为身份未知。
README、模块配置和工作流对 Go/Node/tmux、静态二进制、测试门禁及发布流程的描述相互一致；API 文档双向校验、真实 tmux 测试和多类专项检查显示较强的内部一致性。依赖可用性因 Go 1.26.6、Node 22、tmux、GitHub 下载及外部证书/聊天服务等环境要求而扣分；故障反馈有 doctor、未知环境变量告警、校验拒绝和服务日志入口，但材料没有覆盖所有运行时、网络、认证和恢复错误的用户提示。
目标用户和场景定义清楚，覆盖多项目、多会话、桌面、手机、远程聊天、API、用户/系统服务、Docker及受限网络安装。命令、环境变量优先级和会话触发方式具体，远程自然语言操作还要求 ok，触发精度证据较强。能力边界仍有扣分：这是可执行任意终端命令并通过网络访问的高能力控制台，材料未完整界定项目隔离、文件系统边界、API 令牌权限粒度或多用户授权模型。
README 信息层次清晰，并指向安装、功能和 API 文档；提供交互式、镜像、无人值守、Docker、源码构建及运维命令。命名稳定性由 VIBEPANEL_* 检测和 API/路由双向检查支持。许可证正文、商业限制、归属义务和旧版 MIT 分界非常明确。扣分在于所给证据只有若干示例而没有实际 FAQ 内容；已说明项目尚早、浏览器检查仅为本地门禁等局限，但没有集中、完整的限制清单；使用标签发布却未提供独立 changelog；维护者姓名和邮箱明确，但没有维护政策、响应预期、继任或治理说明，且发布者身份未由企业注册表验证。
面板将持久 tmux 会话、状态、排序、文件管理、移动端、通知、审批和 API 汇集为可操作界面，对并行使用编码代理具有明确增量价值；输出状态、会话编号、允许/拒绝卡片、截图及监控视图具备直接可用性。成本收益因部署和维护 tmux/TLS/认证/外部聊天集成的复杂度、远程终端的安全负担以及非商业许可证对企业使用的限制而未给满分。
关键主张通常对应具体机制或检查名称，例如固定修复版工具链、SHA256SUMS、CI 门禁、API/路由一致性检查及聊天默认断网测试；LICENSE、go.mod 与两个工作流也对 README 多项陈述形成交叉印证，因此跨来源佐证充分。扣分在于本次材料没有提供被引用的功能、安装、API 文档正文或测试实现，无法逐项追溯全部安全与隐私主张；README 也混合了可核查事实和“稳定、私密、好用”等主观营销判断，未始终明确区分事实与推断。
- 这是静态、低置信度评估；未执行程序、测试、安装器或升级流程。
- 部署后可远程控制终端和文件。启用公网访问前应独立核查认证、TLS、API 令牌权限、会话隔离、审计日志和凭据存储。
- 避免在未审阅固定修订版 install.sh 前使用 curl 管道安装；应验证发布标签、SHA256SUMS 与下载来源。
- Telegram、飞书或微信启用后会产生外部数据流；应确认具体传输内容、服务商保留政策、管理员可见性和撤销流程。
- PolyForm Noncommercial 条款通常不允许公司内部业务使用；商业或企业部署前需取得适用许可证并进行法律审查。