Claude Super Sidebar
把主 Agent、子 Agent 关系与对话任务流收进一个侧边栏面板，随时看清 Agent 在做什么。
- Star 数
- ★ 155
- 最近更新
- 7 天前
- License
- Apache-2.0
- 主语言
- JavaScript
- FA 评分
- 58/100 · 缺口较多
30 秒速览
- 可在哪里用
- 平台专用Codex · Claude Code（部分支持）
- 开始前需要
- 典型场景
- 使用 Claude Code 同时调度多个子 Agent 时，想一眼看清父子关系与每个 Agent 的运行、等待、完成、失败状态。
- 主要局限
- Claude 侧依赖早期访问的插件 API（基于 engine 2.1.299 开发），宿主必须支持 hook modules、claude-code 导入与原生 ui.render，不同发行版与版本可能不可用。
- 源码审查
- 58/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Claude Super Sidebar 是一个面向 Claude Code 与 Codex 的可视化侧边栏。对 Claude Desktop Code，它以原生插件形式安装为 super-sidebar，通过 hooks/register.tsx 注册生命周期钩子、命令与刷新定时器，由 hooks/pane.tsx 渲染标题为「状态 · Status」的单列原生面板。对独立的 Codex CLI/App，它提供 codex/server.mjs 本地只读服务，增量读取 CODEX_HOME/sessions 下的 rollout-*.jsonl 文件，并在浏览器中打开只读面板。两条路径都由 hooks/steps.ts 之类的本地解析逻辑把对话记录归类为工作阶段，不额外调用大模型。仓库同时包含 32 项可移植测试，分为 Claude 侧 9 项与 Codex 侧 23 项。
在 Claude 侧，插件清单经 hooks/hooks.json 加载 hooks/register.tsx，会话启动时注册 /super-sidebar 命令与两秒刷新定时器，生命周期钩子观察 Agent、轮次与工具事件，session.messages() 提供对话记录供解析器使用；hooks/model.ts 维护状态与 Agent 树，面板展示主 Agent、子 Agent、有向连接线、可展开的执行详情、按阶段分组的工作步骤以及语言与容器配色偏好。在 Codex 侧，npm run codex 启动本地服务器，每两秒增量读取本地会话 JSONL，按绑定线程展示最近一轮最多 30 个操作步骤、成功提交的 update_plan 计划与用量统计，并可通过 ?thread= 参数切换绑定会话。两端都不再调用模型生成摘要，只做本地解析与渲染。
- 使用 Claude Code 同时调度多个子 Agent 时，想一眼看清父子关系与每个 Agent 的运行、等待、完成、失败状态。
- 在与 Codex CLI 协作的本地项目中，想用浏览器侧栏跟踪当前会话的任务阶段、工具调用与计划进展。
- 排查一次长对话为何偏离目标时，需要按阶段回看最近 30 个操作步骤及其结果。
- 希望在不引入额外模型调用与 API 成本的前提下，获得 Agent 执行的可视化视图。
- 团队在做 Claude 插件开发时，想参考一个使用 hook-module 与原生 ui.render 面板的完整实现。
如何安装或部署这个 Agent？
Claude 侧需先具备支持原生 hook-module 与 pane API 的 Claude Desktop Code 宿主，以及与宿主匹配的 Claude Code CLI，并保留一份本地仓库副本。从 GitHub 添加 marketplace 后安装插件：
claude plugin marketplace add Zafer-Liu/claude-super-sidebar
claude plugin install super-sidebar@super-sidebar若使用本地克隆，在仓库根目录执行：
claude plugin install super-sidebar --marketplace . --scope user确认安装记录并检查是否启用：
claude plugin list --json
claude plugin enable super-sidebar@super-sidebarCodex 侧只需要 Node.js 22.18+ 和本地已保存的 Codex 会话，无需 npm install、API 密钥或修改 Codex 配置。
如何使用这个 Agent？
安装后开启一个新的 Code 会话以加载插件；插件会尝试自动打开「状态 · Status」，也可在对话输入框输入 /super-sidebar 重新打开。面板提供「展开 / 收起」与「刷新」，并每两秒自动刷新。
Codex 独立面板从仓库目录启动：
npm run codex -- --cwd "/absolute/path/to/your/project"随后打开 http://127.0.0.1:4317。需要指定端口、数据目录或线程绑定时：
node codex/server.mjs --cwd "/path/to/project" --port 4318 --codex-home "/path/to/codex/data"
npm run codex -- --cwd "/absolute/path/to/your/project" --thread "full-thread-id"验证配置与运行测试：
claude plugin validate .
npm run test:claude
npm run test:codex这个 Agent 有哪些优点和局限？
- Claude 侧是真正的原生插件面板（ui.render），而不是外部窗口；Codex 侧则用只读本地网页面板，两种宿主各自使用自己的数据源。
- 任务流由本地解析生成，明确不发起额外 LLM 调用，因此没有额外 token 成本与延迟。
- 区分「操作完成」与「验证结论」，并标注验证为 assistant-reported，避免把退出码 0 误当作产品行为正确。
- 测试无需安装依赖即可运行，Claude 与 Codex 两侧合计 32 项可移植测试，并附有审计报告与验证截图。
- 面板支持中英文与白、米、黑三种容器配色，Codex 面板无需 API 密钥即可启动。
- Claude 侧依赖早期访问的插件 API（基于 engine 2.1.299 开发），宿主必须支持 hook modules、claude-code 导入与原生 ui.render，不同发行版与版本可能不可用。
- 最新隔离修复后的回归用例只编写未运行，本轮审计也未能找到可运行的兼容 Claude Code CLI，原生 validate、plugin test 与 Desktop 加载均未重跑。
- Codex 面板读取的 rollout JSONL 格式并非稳定公开 API，兼容性仅限 Codex CLI 0.162.1 与本机 App 会话记录；临时、远程、归档与未持久化会话被排除。
- Codex 面板是只读的伴生浏览器界面，不能驱动对话；未绑定线程时最多发现 100 个会话，也不提供多用户认证或远程监控。
- Codex 用量中的「最后一次请求输入 token」不等于实时上下文占用，异常退出可能留下最后一次观测到的状态。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Claude Super Sidebar 当前 | 58 · 缺口较多 | — | ★ 155 | 7 天前 | JavaScript | — |
| Ordewell | 67 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 206 | 今天 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| AgentBridge | 61 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 416 | 1 个月前 | TypeScript | Codex · Claude Code |
| Codex 动态工作流（Claude Code 技能） | 53 · 缺口较多 | — | ★ 327 | 3 个月前 | JavaScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 明确说明 Codex 面板为只读、仅读取本地 JSONL、不驱动对话、无需 API key，且不新增模型或配置提供方，权限面相对克制（least_privilege=2）。但安装与启用流程没有显式确认步骤，插件在会话启动时自动尝试打开面板，用户确认机制薄弱（user_confirmation=1）。数据流在 README 的 How it works 与 Codex 配置段落有较清晰描述（data_flow_transparency=2）。敏感数据处理仅提到提交问题时需去除敏感信息，未说明本地会话记录、token 用量等敏感数据的存储、脱敏或访问控制（sensitive_data_handling=1）。package.json 无任何依赖声明，也无锁文件或依赖审计说明，依赖安全无法评估（dependency_security=1）。外部副作用有限：只读面板、本地端口 4317/4318、不修改 Codex 配置（external_effects=2）。回滚方面仅提到 Ctrl+C 停止与插件 enable/disable，未提供卸载、清理缓存副本或状态恢复指引（rollback=1）。来源归属清晰：README 标注作者 Zafer_Liu 与个人站点，LICENSE 为 Apache-2.0（source_attribution=2）。
README 对 Claude 与 Codex 两条路径的验证状态描述一致且诚实，承认最新隔离回归未运行、原生引擎验证未完成，内部叙述自洽（self_consistency=2）。依赖可用性方面仅声明 Node.js >=22.18，无第三方包，但 Claude 侧依赖早期访问插件 API 与特定引擎 2.1.299，可用性高度不确定（dependency_availability=1）。失败信息方面仅提到畸形行会被跳过并提示、缺失记录显示等待状态，未系统说明错误提示与诊断方式（failure_messages=1）。
受众与场景明确区分 Claude Desktop Code 与独立 Codex CLI/App 两类用户（audience_and_scenarios=2）。能力边界写得非常充分：明确不驱动对话、不做多用户认证、不做远程监控、不聚合跨会话历史、不新增模型（capability_boundaries=3）。触发精度方面有 /super-sidebar 命令、启动自动打开、两秒刷新、--thread 与 ?thread= 绑定规则，但自动打开与刷新行为对用户可控性描述有限（trigger_precision=2）。环境适配受限于早期访问插件 API 与特定引擎版本，Codex rollout 格式非稳定公共 API，兼容范围窄（environment_fit=1）。
信息架构优秀：目录职责表、章节锚点导航、双语 README、清晰的 How it works 图（information_architecture=3）。安装说明给出 marketplace 与本地克隆两种路径及验证命令，但依赖未验证的宿主 API，且未覆盖卸载（install_notes=2）。命名稳定性方面主动解释了 claude- 前缀限制与插件 ID 差异，但产品名、插件名、面板标题多处不同，存在一定认知负担（naming_stability=2）。示例与 FAQ 仅有示意性 SVG 布局图并声明非运行时截图，无 FAQ（examples_and_faq=1）。已知限制章节详尽且诚实（known_limitations=3）。LICENSE 为完整 Apache-2.0 文本（license=3）。版本号 0.2.0 出现在徽章与 package.json，但无 CHANGELOG（versioning_changelog=1）。维护责任仅指向作者个人站点与欢迎 issue/PR，无治理、支持渠道或安全披露流程，且发布者身份未经核实（maintenance_responsibility=1）。
输出可用性方面，面板展示 agent 树、任务流、状态与用量，对观察多 agent 执行有实际价值，但 Claude 原生面板当前未验证、Codex 面板为只读且不含会话选择器（output_usability=2）。边际价值在于把分散的会话记录整理为可视化任务流且无需额外模型调用，属于增量改进而非不可替代（marginal_value=2）。成本收益上无需 npm install、无额外 LLM 调用、本地解析，成本低；但依赖早期访问 API 与不稳定 rollout 格式带来维护成本（cost_benefit=2）。
README 给出测试命令与历史通过数（32 passed），并链接审计报告与验证证据目录，声明可追溯（claim_traceability=2）。但本次仅提供 README、LICENSE、package.json 三个文件，测试文件、审计报告与验证证据均未在证据中呈现，无法交叉印证（cross_source_corroboration=1）。事实与推断分离做得很好：明确区分历史证据与当前未验证项，声明示意图为示例数据而非运行时截图，强调 exit code 0 不等于产品行为正确（fact_inference_separation=3）。
- Claude 原生插件依赖早期访问的 hook-module 与 ui.render API，且仅针对引擎 2.1.299 开发；当前原生验证、Desktop 加载与自动打开均未重新运行，实际可用性未知。
- Codex 面板读取的 rollout JSONL 格式并非稳定公共 API，兼容性仅限已测试的本地版本，升级 Codex 后可能失效。
- 插件在会话启动时自动尝试打开面板，缺少显式用户确认；安装与启用流程也未说明卸载与缓存清理方式。
- 本地会话记录与 token 用量等敏感数据的存储、脱敏与访问控制未在文档中说明；面板无多用户认证，不应暴露到非本机网络。
- package.json 未声明任何依赖，也无锁文件或依赖审计，依赖安全无法评估；发布者身份未经核实，维护与安全披露渠道不明确。
- 测试通过数、审计报告与验证证据在本次证据中未提供，无法独立交叉印证。