AgentOS Vibe 项目

项目简介

AgentOS 是一个自托管、移动优先的 AI 编码代理管理台。它把 Claude Code、Codex、Gemini CLI、Aider、OpenCode 等命令行编码代理集中到一个网页界面，让你在手机上就能指挥它们干活：并排开会话、直接对话或切进终端、把任务甩给代理去完成并产出拉取请求。项目完全免费开源，跑在自己的机器上。

核心功能

1. 移动优先界面：从底层围绕触屏交互设计，配备终端专用按键的虚拟键盘与滑动手势，而非简单的响应式降级页面。
2. 多窗格会话：最多四个代理会话并排运行，每个窗格还能开多个标签，方便同时驱动多个代理或并排对比不同模型的输出。
3. tmux 持久化：所有会话都寄宿在 tmux 里，关掉浏览器甚至换台设备回来都能接着干，代理的长任务不会因为页面关闭而中断。
4. 聊天与终端双模式：聊天视图支持流式回复、可展开的工具调用、内嵌差异、计划清单、图表与图片附件，可随时与终端交接，切换时自动关闭另一侧，保证同一时刻只有一个驱动方。
5. 任务到拉取请求流水线：给一个项目和一句提示，自动创建独立分支与工作区、启动代理并跟踪状态；代理完成自检代码审查并推送后，由人工签收合并，杜绝代理自行合并代码。
6. Git 全家桶：状态、差异、提交、拉取请求、独立工作区、代码搜索、文件选择与克隆仓库全在界面内完成，还能一键启停本地开发服务器。
7. 多机协同：配好密钥可达的机器，其会话与本地会话并排挂在同一项目下统一调度。
8. 语音输入与权限控制：语音转文字提问；三档访问权限决定代理自主执行的程度，待确认事项以卡片弹出待批。

技术实现

AgentOS 的技术底座是 Next.js 与 React 构建的前后端，本地状态用 SQLite 持久化，终端渲染基于 xterm.js。每一个会话进程都寄宿在 tmux 会话里，服务重启或升级时会自动重连正在运行的工作进程，因此聊天轮次不会被切断。聊天模式通过官方代理软件开发工具包驱动 Claude Code，复用用户自己的登录凭证；终端模式则通过恢复命令接回同一段对话，两侧互斥驱动。会话编排采用指挥者与工作者模型，经由模型上下文协议通信，一个代理可以把任务委派给另一个代理，后台子任务以独立进度芯片呈现，各有计时与停止按钮。代码搜索由 ripgrep 提供并带语法高亮，跨机器会话通过密钥寻址，外网访问推荐用 Tailscale 组网。桌面端提供 macOS 与 Linux 原生安装包，本质是给网页界面套一层壳，后端仍需本地运行；不想自托管也有官方云主机方案可选。

快速上手

1. 装好 Node.js 20+ 环境，全局安装：npm install -g @saadnvd1/agent-os
2. 运行 agent-os install，脚本自动装好 tmux、ripgrep 并完成前端构建
3. 执行 agent-os start 启动服务，在浏览器打开本机 3011 端口即可使用
4. 手机与电脑装上 Tailscale 并登录同一账号，用手机访问主机私有地址即可远程指挥代理
5. （可选）新机器用一键安装脚本，或下载 macOS、Linux 桌面应用获得原生窗口

适用人群

需要在通勤、出差途中处理线上问题的开发者；同时跑多个 AI 编码代理做方案对比的重度用户；管理多台开发机、希望统一调度会话的工程师；以及厌倦在多个终端窗口间切换的 Claude Code 用户。