Sidekick Agent Hub
实时查看 AI 编码智能体在做什么、花了多少钱:活动地图、token、成本、上下文与配额,覆盖 Claude Code、Codex 和 OpenCode,在 VS Code 和终端均可使用。
- Star 数
- ★ 91
- 最近更新
- 2 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 73/100 · 存在缺口
30 秒速览
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 开始前需要
- 典型场景
- 重度 Claude Code 用户想知道每次会话烧了多少 token、上下文何时接近上限
- 主要局限
- 仅支持 Claude Code、Codex 和 OpenCode 三种智能体的会话监控,其他智能体无数据可读
- 官网
- cesarandreslopez.github.io ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-19
- 源码审查
- 73/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
Sidekick Agent Hub(仓库 cesarandreslopez/sidekick-agent-hub,MIT 许可,最新版本 0.33.5)是一个 AI 编码智能体监控工具,包含 VS Code 扩展和终端 CLI 两个产品。它直接读取 Claude Code、Codex 和 OpenCode 已经写下的会话文件,无需代理或包装器,运行方式不变。核心能力包括:十一站点活动地图(文件、shell、网络、记忆、浏览器、子智能体等)、token 与成本统计、上下文填充、5 小时计费块与计划配额预测,以及跨会话的任务、决策和知识笔记。它还提供账户切换器(Claude Code 和 Codex 多账户免 /logout 切换)、一个智能体可查询的只读 MCP 服务器(sidekick mcp)、Claude Code 状态栏(sidekick statusline),以及供 tmux 栏和脚本使用的公开 state.json 快照。VS Code 扩展还支持通过 Claude Max、Claude API、OpenCode 或 Codex 运行内联补全、代码转换、提交信息、PR 描述和代码审查等 AI 功能。
Sidekick 解析本地智能体会话文件并产出实时视图与报告。活动地图把每次工具调用分派到十一个站点之一(files、shell、network、memory、browser、agents、skills、hooks、plan、model、you),并显示故障、子智能体和智能体路径;Insights 分析时间、错误与上下文去向,捕获重试连击和『编辑↔测试』循环。会话分析面板展示每会话/每模型的 token 与成本、上下文填充、5 小时与每周配额预测、开放计费块及其燃烧率,支持按日/周/月/会话生成使用报告。CLI 提供 sidekick dashboard(九面板全屏视图)、sidekick map --follow(实时活动地图)、sidekick quota --all、sidekick daily、sidekick blocks、sidekick report(自包含 HTML 报告)、sidekick dump --prompts、sidekick search 和 sidekick doctor 等命令。sidekick mcp 启动一个只读 MCP 服务器,让运行中的智能体查询自身配额、燃烧率、上下文压力、活动地图和项目笔记;sidekick statusline 作为 Claude Code 的状态栏,同时记录官方速率限制。sidekick accounts 管理并切换已登录的 Claude Code 和 Codex 账户,VS Code 可通过 sidekick.accounts.autoSwitchThreshold 在配额越限时自动切换到健康的账户。
- 重度 Claude Code 用户想知道每次会话烧了多少 token、上下文何时接近上限
- 在 Pro/Max 订阅配额下工作的开发者,需要预测 5 小时计费块和每周配额的消耗节奏
- 同时在多个 Claude Code / Codex 账户之间工作、希望免 /logout 快速切换的人
- 想在会话结束后保留任务、决策和交接笔记,让下一次会话不必从零开始的开发者
- 喜欢终端工作流、想在 tmux 分屏里用 sidekick map --follow 跟踪智能体活动的工程师
- 希望智能体自身能通过 MCP 查询配额和上下文压力,避免中途撞墙的用户
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm install -g sidekick-agent-hub
- 配置文件
~/.claude/settings.json- 运行环境
- Node.js 20+
如何安装或部署这个 Agent?
VS Code:从 VS Code Marketplace 或 Open VSX 安装扩展 Sidekick Agent Hub(VS Code Marketplace ID 为 CesarAndresLopez.sidekick-for-max),然后在活动栏打开 Agent Hub 图标。
终端需要 Node.js 20+(读取压缩的 Codex 会话需 22.15+):
npm install -g sidekick-agent-hubnpm 包名为 sidekick-agent-hub,安装后的命令是 sidekick。无需代理或包装器,继续按原样运行 claude、codex 或 opencode 即可;OpenCode 数据库会话监控需要环境中存在可执行的 sqlite3。
如何使用这个 Agent?
终端启动全屏仪表盘(九个面板:Sessions、Tasks、Kanban、Notes、Decisions、Plans、Events、Charts、Map):
sidekick dashboard常用一次性命令:
sidekick map --follow
sidekick quota --all
sidekick daily
sidekick blocks
sidekick report
sidekick dump --prompts
sidekick search "migration"
sidekick doctor
sidekick accounts注册 MCP 服务器让智能体查询自身状态:
claude mcp add sidekick -- sidekick mcp
codex mcp add sidekick -- sidekick mcpClaude Code 状态栏,在 ~/.claude/settings.json 中加入:
"statusLine": { "type": "command", "command": "sidekick statusline" }VS Code 中通过 Agent Hub 侧边栏访问 Session Analytics、Activity Map(可在编辑器标签页中打开以拖动回放)、Accounts、Mind Map、Kanban Board、Plans、Project Timeline、Knowledge Notes、Subagents 和 Event Stream。
这个 Agent 有哪些优点和局限?
- 无需代理或包装器:直接读取智能体已写的会话文件,保持现有 claude/codex/opencode 工作流不变
- 同一数据同时提供 VS Code 扩展、终端 TUI、一次性 CLI 命令、MCP 服务器和公开 state.json 快照,多种接入方式
- 活动地图将工具调用分派到十一个站点并回放智能体路径,Insights 能捕获重试连击和编辑↔测试循环
- 配额预测覆盖 5 小时计费块、燃烧率和每周配额,且账户切换无需 /logout 循环
- 仅支持 Claude Code、Codex 和 OpenCode 三种智能体的会话监控,其他智能体无数据可读
- OpenCode 数据库会话监控依赖宿主机存在可执行的 sqlite3 运行时
- 无法定价的成本显示为 — 而非 $0,成本数据依赖会话日志中的定价信息
- MCP 服务器是只读的,智能体只能查询状态,不能通过它控制智能体
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Sidekick Agent Hub 当前 | 73 · 存在缺口 | — | ★ 91 | 2 天前 | TypeScript | Codex · Claude Code |
| ccusage | 66 · 存在缺口 | — | ★ 20k | 今天 | Rust | Codex · Claude Code |
| Ordewell | 87 · 表现良好 | 命令行工具免费 + 模型费 | ★ 211 | 今天 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| NeuroSquad 终端控制台 | 80 · 表现良好 | 命令行工具免费 + 模型费 | ★ 31 | 1 个月前 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
监控为只读、MCP 服务器明确声明只读、无代理无包装,最小权限总体达标,扣分点在于账号切换功能会注册/切换 Claude Code 与 Codex 登录态,触及凭据文件但未见凭据处理细节。自动切换(autoSwitchThreshold)可在配额越过阈值时自动换号,用户确认偏弱。数据流透明:SECURITY.md 声明无遥测、代码仅发往 Anthropic,但安全策略仅覆盖扩展且版本表停在 0.2.x。依赖安全:包内未见 lockfile/依赖清单证据,仅口头建议保持更新,记 1。外部影响:写 state.json、切换登录等有副作用但均有文档;回滚明确('Switches are verified and can be undone')。来源归属出色:trawl 贡献者、THIRD_PARTY_NOTICES、CONTRIBUTORS 均有署名。
AGENTS.md 与 README/CI 相互一致,提供 doctor 诊断、结构化 onDiagnostic、sqlite3 缺失时报诊断而非构造失败,失败消息机制有据。扣分:SECURITY.md 的支持版本表(0.2.x)与实际 0.33.5 明显脱节,自洽性受损;依赖可用性依赖 Node 20/22 与外部 sqlite3,文档已注明版本差异。
受众与场景清晰(VS Code、CLI、脚本化 one-shot、多 provider 表)。环境适配充分:Cursor 冲突提示、Node 版本、SEA 构建、Open VSX。能力边界有 OpenCode sqlite3 说明和 provider 能力表,但未见统一的功能限制清单。触发精度:内联补全改为 on-demand 且可配置 debounce,表达清楚。
信息架构极佳:monorepo 结构、文档站、架构页、CLI 指南链接齐全;安装说明覆盖 Marketplace/Open VSX/VSIX/源码/npm 并验证 sidekick --help。命名稳定性扣分:Marketplace ID 仍是 'sidekick-for-max',npm 包名与命令名不同(已解释)属于遗留痕迹。示例有 walkthrough 与 CLI 命令,但 FAQ 未见。已知限制散见(OpenCode note、Cursor note)。License MIT 完整且含第三方声明。版本 0.33.5 与 changelog 指向明确,但 SECURITY.md 版本陈旧。维护责任为单人维护,响应时限有承诺但属声明。
输出可用性强:活动地图、配额投影、HTML 报告、state.json 供脚本消费、'never $0' 的定价诚实性说明。边际价值明确——读既有会话文件、零侵入监控、上下文延续,区别于同类代理。成本收益记 2:宣称无代理无包装开销,但静态审查无法验证运行时开销。
声明可追溯:CI badge、架构文档、provider 文档链接、演示录制脚本可复核。跨源印证较强:README/AGENTS.md/CLAUDE.md/CI 工作流一致;扣分在 SECURITY.md 与版本现状矛盾。事实与推断分离良好:如'无法定价的读作 — 而非 $0'、 provenance 字段(PricingProvenance、TranscriptSourceProvenance)显式区分推断与来源。
- 账号自动切换(autoSwitchThreshold)会在配额越过阈值时自动更换登录账号,敏感操作前请关闭或确认。
- SECURITY.md 的支持版本表(0.2.x)与当前 0.33.5 不符,且安全策略仅覆盖扩展包,CLI/共享库不在其声明范围内。
- 账号切换功能涉及 Claude Code/Codex 凭据文件,静态审查未见其读写细节,使用前建议自行核阅相关源码。
- OpenCode DB 监控要求宿主环境存在可执行的 sqlite3,缺失时功能降级。
- 发布者未经认证,为单人维护项目,依赖更新与安全响应无第三方背书。
常见问题
Sidekick Agent Hub 官网是什么?
Sidekick Agent Hub 开源吗?
Sidekick Agent Hub 安全吗?
Sidekick Agent Hub 还在维护吗?
Sidekick Agent Hub 是谁开发的?
谢谢反馈,我们会据此改进页面。