SirAllap/agentglass

🛰 Every AI coding agent on your machine, on one screen — live cost, tokens and tool calls across every provider, and a hold on anything dangerous until you say go. From your desk or your phone.

什么是 agentglass？

agentglass 是一个桌面应用程序，让你在一个窗口中监控和交互你已经在机器上运行的编码代理（Claude Code、Codex、Gemini CLI、OpenCode 等）。它接入这些代理所使用的 tmux 会话和 Git 工作树，然后将它们的终端、拉取请求差异、浏览器交互、审批、Docker 容器、日志和资源使用情况全部呈现出来，而无需你在多个独立工具之间频繁切换 Alt-Tab。

核心理念

理念	含义
一个统一的工作区	所有与代理相关的 UI（tmux 面板、git 差异查看器、PR 面板、浏览器、审批）都集中在一个 Electron/React 窗口中。
附加，而非替代	agentglass 启动你已使用的相同 CLI；它只是附加到 tmux 会话，因此即使关闭 UI，代理也会继续运行。
本地优先，隐私优先	所有数据都存储在本地 SQLite 文件中。无需云账户，无遥测数据。唯一可能向外发送数据的只有你自行配置的可选 Webhook 和“解释”按钮（默认关闭）。
通过插件可扩展	插件以独立进程运行，使用作用域受限、可撤销的令牌，可通过应用内目录安装。
移动伴侣	安卓应用可通过扫描二维码与桌面实例配对，让你在移动设备上查看审批、PR 和终端输出。

主要功能

代理管理 – 从任务或 GitHub 问题启动代理；每个代理创建一个 git 工作树、分支和 tmux 面板。
真实 tmux 终端 – 查看并控制实际的 tmux 面板；点击 make 目标或 npm 脚本即可运行。
Lantern 状态栏 – 红/琥珀色指示灯显示代理正在等待权限门禁或已完成工作等待你输入。
差异查看器 – 按代理/工作树分组的单词级变更；可直接进行暂存、提交、储藏或解决冲突。
拉取请求面板 – 查看检查项、对话、文件，并在不打开浏览器的情况下编写内联评论。
浏览器面板 – 代理可驱动内置的 Chromium 视图；浏览器已使用你的凭据登录。
系统视图 – Docker 容器、日志、监听端口、CPU/内存使用情况，以及每个会话的成本追踪。
安卓伴侣 – 通过二维码配对，手机上可查看相同面板和审批。
插件系统 – 可添加新面板或集成；插件使用细粒度令牌沙箱运行。

安装与运行

下载最新发布中的合适二进制文件（AppImage、.deb、.dmg、.exe 或 .apk）。无需单独的服务器进程。
macOS 注意 – 未签名的构建会触发 Gatekeeper；运行一次 xattr -dr com.apple.quarantine /Applications/agentglass.app 即可。

从源码构建（需 Bun、Python 3、git、tmux、Claude Code CLI）：

git clone https://github.com/SirAllap/agentglass && cd agentglass
bun install
AGENTGLASS_STATE_DIR=~/.local/state/agentglass-dev bun run dev   # UI 地址为 http://localhost:4000
python3 hooks/install_hooks.py   # 注册 Claude Code 钩子

请参考 docs/INSTALL.md 了解平台特定的前置条件（git、tmux、GitHub CLI、Docker 等）。

支持的平台

操作系统	状态	发布格式
Linux	✅ 正常运行	AppImage、.deb
macOS	✅ 正常运行（未签名）	.dmg（Intel 与 Apple-silicon）
Windows	🧪 实际硬件上未验证（CI 通过）	.exe
Android	✅ 正常运行	.apk（配对伴侣应用）

安全与隐私

数据本地存储 – 所有状态保存在你磁盘上的单个 SQLite 文件中。
无默认出站流量 – 仅两个可选功能可向外发送数据：
1. 由用户配置的 Webhook。
2. “解释”按钮，可将选中的差异发送至语言模型（默认关闭）。
令牌作用域插件 – 每个插件以独立进程运行，使用可撤销的令牌限制其访问权限。
详细信任模型、保留策略及漏洞报告方式请参阅 SECURITY.md。

可扩展性

参考 docs/EXTENDING.md 和 PLUGINS.md 编写插件：定义所需 HTTP API，申请作用域令牌，通过应用内目录发布。
架构为 Bun/SQLite 后端、React/Vite UI、Electron 桌面外壳，以及用于 Claude Code 钩子的轻量级 Python 转发器。

发展路线图亮点

当前：基于 Lantern 的裁决条、macOS 签名/公证、并行代理的冲突警告。
下一步：基于规则的工具门禁、项目级门禁策略、MCP 基础的机舱查询、Windows 硬件验证。
未来：单提示词提交的就地差异审查、舰队端点的 API 面板、决策日志挖掘、语音输入。

社区与贡献

GitHub 上的讨论、问题追踪器和“帮助我”标签均活跃。
鼓励贡献；项目旨在保持轻量（Bun、SQLite、React、Electron、React-Native、stdlib Python）。
许可证：MIT（2026），捆绑的艺术作品另附 CC-BY-4.0 许可。

简而言之：agentglass 是一个以隐私为先、本地运行的 UI，让开发者能在一个可扩展的窗口中，统一管理所有 AI 编码代理的工作流——包括终端、PR 审查、差异、浏览器操作和审批。