
agent-control
Self-hosted desktop & mobile remote control console for Codex, Claude Code, Antigravity, and Grok.
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up agent-control (git-clone project) into my current project. Found on https://claudeers.com/agent-control Repo: https://github.com/guuguo/agent-control Homepage/docs: https://hub.guuguo.top/agent-control Detected install method: git-clone → git clone https://github.com/guuguo/agent-control Category: devtools. Platforms: cli, api, desktop, web, mobile. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: unknown; community-verified: false. Confirm the source before running anything.
git clone https://github.com/guuguo/agent-control
// compatibility
| Platforms | cli, api, desktop, web, mobile |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | AGPL-3.0 |
| Pricing | open-source |
| Language | JavaScript |
简体中文 · English · 日本語 · 한국어 · 繁體中文
Agent Control
在电脑和手机上统一看 Codex、Claude Code、Antigravity 和 Grok 的任务进度、随时续跑对话与批复权限 —— 一条命令装好即用,不改动原工具的任何配置与记录。 如果这个工具帮到了你,欢迎点击右上角 Star ⭐️ 支持一下。

14 秒总览:3D 梦工厂 · 多账号只读看板 · 5 秒扫码手机操控 · 开车免提语音审批
| 手机端 · 项目总控与 4 家实时监控 | 手机端 · 富文本对话、代码块与排队控制 |
![]() | ![]() |
更多核心界面(免提语音总控 · 手机扫码隧道 · 一键更新与桌面壳子同步)
| 🚗 开车 / 免提语音总控 | 📱 一键免费隧道与固定链接 | 🔄 一键更新与桌面 App 同步 |
![]() | ![]() | ![]() |
⚡ 一行命令装好直接用
只需要本机有 Node.js 22+ 和 Git(如未安装,脚本会自动提示安装命令)。
macOS / Linux(打开「终端」粘贴回车):
curl -fsSL https://hub.guuguo.top/install/agent-control.sh | bash
Linux 支持 GTK/WebKitGTK 原生桌面壳和 systemd 用户服务;桌面依赖安装及无桌面、SSH、容器、WSL 的运行方式见 Linux 安装与运行。
Windows(打开 PowerShell 粘贴回车):
(irm https://hub.guuguo.top/install/agent-control.ps1).TrimStart([char]0xFEFF) | iex
✨ 装完怎么用?
- 打开即用:安装完成后会自动打开控制台(macOS 会在「应用程序」生成 Agent Control 独立桌面应用,也可浏览器打开
http://127.0.0.1:43310)。 - 电脑端统一管理:左侧按项目查看所有正在跑或历史中的智能体任务,点进去即可续发消息、切换模型、设置自动推进或批量归档;同一智能体存在多个账号(如多 Codex 账号)时,列表与顶部栏自动标出具体账号归属。
- 手机扫码远程看:点页面右上角 「手机远程」 生成二维码,手机扫一下就能随时看输出、发指令、批权限。👉 查看手机扫码图文教程 · 固定链接与容器部署全指南
- 🚗 开车 / 免提语音总控(不强依赖 Gemini):点击顶部 「通话」 按钮即可开启免提语音通话(支持屏幕常亮、VAD 自动断句、说话打断、后台任务完成/待审批自动语音提醒与口头批准/拒绝)。
- 可选低延迟模型:不是所有人都有 Gemini/Antigravity,语音弹窗顶部支持直接切换后端模型——自动优选或手动选用 Claude Sonnet(低思考)、GPT-6.1 Terra(低思考)、Antigravity Hydrogen / Flash、Grok。所有非空语音内容均交由所选模型理解意图、定位目标并决定操作;模型不可用时明确报错,不回退到关键词规则。
- 跨平台语音收发:macOS 优先使用本地
mlx-whisper离线识别与edge-tts/say播报;未装本地 Whisper 时可回退为浏览器语音识别。播放只使用服务端生成的音频,不再调用手机或浏览器本机 TTS;没有可播放音频时保留文字并标记未播报(也可随时点击键盘图标打字调度)。
- 🔄 自动检测与跨端一键更新:左上/左下角与手机端菜单实时展示版本状态,支持定期检查远端提交、闲时自动平滑重启,并在更新时按源码指纹自动联动更新 macOS / Windows / Linux 桌面 App 壳子或快捷入口(也可执行
npm run version:bump统一维护服务与 UI 版本)。
展开 Agent 实时监控 可查看执行统计:按 Agent、模型、思考强度汇总成功轮次的中位/P90耗时、首输出、协议 Token 均值和工具次数,并查看最近30轮明细。支持24小时、7天、30天及全部记录筛选。数据从启用后的新轮次开始记录,最多保留5000轮,独立保存在数据目录的 execution-stats.json,不保存指令或回复正文。耗时含工具和审批等待,不含排队;/goal 续跑按轮记录。估算、部分上报、未上报分别标注,不混入协议 Token 均值;跨服务重启未收到终态的轮次标为“结束状态未记录”,不计入成功耗时。
手机远程方案怎么选?(装完随时可换)
安装时默认推荐 Cloudflare 免费临时隧道,同时支持以下固定链接与一键容器方案(在弹窗或命令行随时切换,不用重装):
| 方案 | 费用 | 域名是否固定 | 适合谁 | 特点 |
|---|---|---|---|---|
| Cloudflare 免费临时隧道(默认) | 0 元 | 临时随机 | 大多数人、零门槛体验 | 免服务器、免注册账号,5 秒出二维码、关闭即焚 |
| Tailscale Funnel | 0 元 | 永久固定(*.ts.net) | 想长期收藏到手机、不买域名/服务器 | 免费个人版即送固定 HTTPS 域名,支持在面板一键开启 |
| Cloudflare Named Tunnel | 0 元隧道 | 永久固定(自定义域名) | 手头已有 Cloudflare 托管域名 | 隧道永久免费不限时,服务常驻本机 |
| Sealos / Docker 一键中继 | Sealos 约 ¥5~15/月 | 永久固定 | 高频日用、多设备中继、不暴露本机端口 | 断网/重启自动重连,提供一键容器脚本与 Sealos 模板 |
| 仅本机使用 | 0 元 | — | 只在电脑上使用 | 不装任何隧道组件,后续随时可切换 |
🗑️ 不想用了?一行命令卸载
macOS / Linux:
curl -fsSL https://hub.guuguo.top/uninstall/agent-control.sh | bash
Windows (PowerShell):
(irm https://hub.guuguo.top/uninstall/agent-control.ps1).TrimStart([char]0xFEFF) | iex
进阶用法、命令行切换、自托管部署与开发者说明(按需展开)
1. 命令行快捷管理(macOS / Linux)
agent-control open # 打开桌面应用或控制台
agent-control status # 查看服务状态
agent-control logs # 查看服务日志
agent-control restart # 重启后台服务
agent-control remote status # 查看当前隧道/中继/固定链接状态
agent-control remote cloudflare # 切换或补装 Cloudflare 免费隧道
agent-control remote tailscale # 开启 Tailscale Funnel(0 元永久 *.ts.net)
agent-control remote relay # 切换并绑定自托管固定中继
agent-control update # 拉取最新版本并更新桌面端
2. 非交互指定安装参数
# 默认:Cloudflare 免费临时隧道
curl -fsSL https://hub.guuguo.top/install/agent-control.sh | bash -s -- --remote cloudflare
# Tailscale Funnel(0 元免域名固定链接)
curl -fsSL https://hub.guuguo.top/install/agent-control.sh | bash -s -- --remote tailscale
# 直接连接自己的中继服务器
curl -fsSL https://hub.guuguo.top/install/agent-control.sh | bash -s -- --remote relay --relay-url https://relay.example.com --invite 你的邀请码
# 仅本机使用
curl -fsSL https://hub.guuguo.top/install/agent-control.sh | bash -s -- --remote local
3. 一键容器部署固定中继(Sealos 约 ¥5~15/月 · Docker)
- 任意带 Docker 的服务器(一行容器脚本):
git clone https://github.com/guuguo/agent-control.git && cd agent-control
./deploy/one-click.sh --url https://relay.example.com
# 如无公网 80/443 入站,可加 --cf-token <CloudflareTunnelToken> 自动打通 HTTPS
- Sealos 容器云(实测约 ¥5~15/月):
- 图形界面 App Launchpad 直接填镜像
ghcr.io/guuguo/agent-control-relay:latest(端口8080、挂128Mi存储到/data); - 或用一键脚本
KUBECONFIG=~/.kube/sealos.yaml ./deploy/sealos/deploy.sh --host xxxx.cloud.sealos.run。 - 👉 完整图文步骤与环境变量说明见 docs/remote-deploy.md。
- 图形界面 App Launchpad 直接填镜像
- 签发一次性配对邀请码并在控制台「手机远程」或
agent-control remote relay中绑定:
RELAY_PUBLIC_URL=https://relay.example.com RELAY_KEY=你的密钥 npm run invite -- "My Mac"
4. 常用环境变量与数据目录
- 所有会话通过
<provider>:<profileId>:<rawId>复合 ID 只读索引,重命名/归档/置顶持久化于独立数据目录(macOS:~/Library/Application Support/Agent Control;Windows:%APPDATA%\Agent Control;Linux:~/.local/share/agent-control),不会修改原工具数据库。 - 常用环境变量:
PORT(默认43310)、HOST(默认127.0.0.1)、AGENT_CONTROL_DATA_DIR、AGENT_CONTROL_DISABLE_RELAY、AGENT_CONTROL_TITLE_RULES_FILE、AGENT_CONTROL_CODEX_HOMES、AGENT_CONTROL_CLAUDE_CONFIG_DIRS、AGENT_CONTROL_AGY_APP_DATA_DIRS、CODEX_BIN、CLAUDE_BIN、AGY_BIN。
Qoder CLI
按 Qoder 官方安装说明 安装 CLI,并在服务运行用户下执行 qoder login(旧命令名为 qodercli login,控制台同时支持发现两者)。Agent Control 使用官方 ACP 接口及本机登录状态,不读取登录凭证。
在底部 Agent 选择器选择 Qoder,可使用 Auto、Lite、Performance 模型档位,设置思考强度和权限,发送图片、查看流式回复与工具执行、处理审批、中断任务或加入控制端队列。切换模型、思考或权限后,下一轮重新加载原会话。
规划模式通过规划指令和控制端只读约束执行:拒绝文件写入、终端执行及工具授权请求;不会向不支持 --permission-mode plan 的 CLI 传入该值。
本次接入管理从 Agent Control 创建的 Qoder 会话,历史副本保存在 Agent Control 数据目录下的 qoder-threads.json;不会扫描或修改 Qoder 的外部历史。重启服务后仍通过原 session ID 续接。未提供积分余额查询;赠送额度、模型可用性和费用以对应 Qoder 账号为准。
可通过 QODER_BIN 指定 CLI 路径,AGENT_CONTROL_QODER_CONFIG_DIR 指定 Qoder 配置目录(默认 ~/.qoder)。侧边栏智能体筛选栏右侧的设置按钮可隐藏不常用的入口,显示偏好保存在当前浏览器中;隐藏后会话仍在“全部”中。
5. 本地开发与零消耗测试
git clone https://github.com/guuguo/agent-control.git
cd agent-control
npm install
npm run check
npm test
npm run desktop:install # macOS 构建安装 /Applications/Agent Control.app
全部自动测试均使用 Mock CLI 模拟智能体进程,不消耗任何真实模型 Token。
License
致谢与社区认可
- 感谢 LINUX DO 社区佬友们的交流与反馈
// faq
What is agent-control?
Self-hosted desktop & mobile remote control console for Codex, Claude Code, Antigravity, and Grok.. It is open-source on GitHub.
Is agent-control free to use?
agent-control is open-source under the AGPL-3.0 license, so it is free to use.
What category does agent-control belong to?
agent-control is listed under devtools in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/agent-control)
// retro hit counter
[](https://claudeers.com/agent-control)
// reviews
// guestbook
// related in Developer Tools
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Curs…
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…
Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA




