Agent Console

产品简介

Agent Console（LockedIn Labs 出品）是一款本地优先的 AI 编码代理可观测性平台。它读取本机 Claude Code 与 Codex 会话历史，把每一轮 token 用量、缓存命中、模型选择与按 list-price 估算的成本，全部展示在 127.0.0.1 上的本地控制台里；同时通过一次性 join link 让多台机器（同事笔记本 / 团队构建机）上报到同一个控制台，形成自托管的团队 FinOps 视图。当前版本 v0.4.1，仓库 800+ Star，MIT 协议，无须账号、无须模型 API Key。

核心功能

1. 本地优先的会话观测：直接读取本机已有的 Claude Code 与 Codex 历史日志，不上传任何遥测到 SaaS；本地控制台默认仅监听 127.0.0.1，浏览器需通过 --open 签名登录才能查看数字。
2. Token 用量与缓存命中拆解：按会话维度展示输入 / 输出 / 缓存读写 token，可一眼看出哪些对话命中了 prompt cache、哪些打断了缓存前缀（cache break），并标注每次打断带来的额外成本。
3. 按 dated 表格估算成本：美元数字来自控制台内置的离线 list-price 表（更新日期明确标注在界面中），避免把"模型实际费率"与"测量数据"混在一起估算。
4. 多机器 join 与聚合：在控制台机器上执行 node bin/agent-console.mjs --listen 0.0.0.0 --open，再在另一台机器粘贴一次性 join link（最长 1 小时有效、屏幕遮罩显示），即可让该机器加入视图；同名使用者会被自动合并为一行。
5. TLS 证书固定的多机上报：从机通过 TLS pinned 到主控台证书上报，证书不一致则拒绝加入，避免第三方在公网链路上冒充主控台。
6. Git 项目视图：提供按 git 项目聚合的视角，展示每个代码库上 Claude Code / Codex 的累计使用情况，方便团队按项目而非按人做成本归因。
7. 首 30 秒上手：启动后立即给出 6 项核心读数（活跃会话、token 用量、缓存命中率、模型分布、当日估算花费、cache break 次数）；任意读数 hover 即可在主界面定位到对应会话。
8. demo 模式：在没有真实会话时可加载合成 5 机团队样本数据，避免与真实测量数据混淆。

特色优势

• 零账户、零模型 Key：不需要登录任何云服务、不需要把模型 API Key 交给控制台；控制台只是历史的"读取器"与成本的"渲染器"。
• 本地端口严格隔离：控制台本身的 UI 始终只监听 127.0.0.1，即使主进程 --listen 0.0.0.0，对外开放的也是另一端口、只服务 join 与 report 两件事。
• 可信签名链：macOS 独立可执行文件已用 Apple Developer ID 签名并通过 Apple 公证；Windows 因暂无代码签名，提供了 SHA256SUMS 校验脚本（installer 先比对校验和再安装到 ~/.local/bin 或 AppData）。
• 安装方式覆盖所有平台：Homebrew（macOS/Linux）、npm 全局安装、源码直接 node bin/agent-console.mjs 运行、Windows PowerShell 安装脚本、GitHub Release .tgz 通过 npx 直接运行——无需 Node.js 22 的机器也能用 standalone 可执行文件跑。
• 离线 list-price 表：成本估算使用 dated 离线表格（首页明示价格检查日期），不联网抓取最新模型费率，避免把"实时费率波动"与"使用量测量"耦合。
• CI 在 Node 22 / 24 上验证：macOS / Linux / Windows 三平台在 GitHub Actions 上跑端到端测试，关键能力（本地读取、跨机 join、Git 项目视图）状态矩阵在控制台首页明列。

应用场景

1. 个人重度使用 Claude Code / Codex 写代码，希望直观看到自己每天 / 每周的 token 燃烧曲线与成本消耗，养成按 cache 命中优化 prompt 习惯的用户。
2. 多机器并行（笔记本 + 远程构建机 / VPS）的开发者，希望把分散在多台机器上的 AI 编码用量集中到一个统一面板上。
3. 小型工程团队（3 - 10 人）想自建 AI 编码 FinOps 视图，但不愿把用量数据托管到 SaaS 或第三方遥测平台，强调本地 + 自托管。
4. 公司安全合规要求"AI 用量不能上云"但又想做内部成本归因，按团队 / 项目维度核算 Claude Code、Codex 等订阅与按量账单。
5. 在多模型之间频繁切换（Claude Opus / Sonnet / Codex / 自托管模型）做 A/B 测试，希望对比同一段代码在不同模型上的 token / 成本 / 缓存命中率差异。
6. 排查某次"为什么这次对话突然变贵"——通过 cache break 统计快速定位是 idle gap 超时还是中途切换模型打断了 prefix。

适用人群

• 日常重度依赖 Claude Code 或 Codex 的独立开发者、兼职顾问
• 在多台设备上并行使用 AI 编码、希望聚合观测的小型工程团队
• 关心 AI 编码成本归属、想用本地 + 自托管替代 SaaS FinOps 平台的技术负责人
• 偏好开源、MIT 协议、本地优先工具的工程师
• 需要在 Windows 10/11、macOS、Linux 三端统一使用同一套代理观测工具的跨平台用户

出品方

Agent Console 由 LockedIn Labs 开源独立维护，仓库地址 LockedinLabs-AI/agent-console，MIT 协议；同时维护 Homebrew tap（LockedinLabs-AI/tap/agent-console），并在 GitHub Releases 上以 tgz / standalone / installer 三种形式分发 v0.4.1。

更新动态

• v0.4.1（2026-10）：发布 tgz 安装包、standalone 可执行文件、Homebrew tap，sha256SUMS 同步公开；本地控制台 UI 升级为签名登录模式（--open 启动自动登录，否则在终端打印一次性登录链接）。
• v0.2.1：引入 demo 模式，可加载合成 5 机团队样本数据，方便先体验再读真实会话。
• 持续在 Node 22 / 24 + macOS / Linux / Windows 矩阵上跑端到端 CI，跨机 join 与 Git 项目视图等关键能力状态在首页表格明示。

官方链接

• GitHub 仓库：https://github.com/LockedinLabs-AI/agent-console
• 项目主页：https://lockedinlabs-ai.github.io/agent-console/
• 安装指南：https://github.com/LockedinLabs-AI/agent-console/blob/main/INSTALL.md
• v0.4.1 Release：https://github.com/LockedinLabs-AI/agent-console/releases/tag/v0.4.1
• Homebrew Tap：https://github.com/LockedinLabs-AI/tap
• Trendshift 排名：https://trendshift.io/repositories/264929