Claude代码终端监控工具

claudeview是一个零配置的终端用户界面(TUI),提供对Claude Code会话的全面可观察性,支持实时流式更新和层次化导航。

  • by Curt-Park
  • Go
  • 本地部署
  • 16 星标
  • 更新于
在 GitHub 查看 Curt-Park/claudeview

使用说明

这是怎么一回事?

claudeview是一个零设置的TUI,它为您提供了对Claude代码会话的完全可观察性。上面写着 ~/.claude/ 直接——没有钩子,没有配置,没有要运行的代理。项目、会话、代理、工具调用、插件和内存都可以从一个终端界面通过实时流媒体更新进行导航。

核心设计

仪表板遵循k9s模型:使用vim风格的导航进行分层深入。 j/k 移动, enter 为了深入挖掘, esc 回去, / 过滤。每个视图在1秒内刷新,历史视图支持跟踪模式——自动滚动到最新回合,如 tail -f 正如克劳德所写。

关键能力

  1. 会话层次结构 --单个可导航树中的项目、会话、代理和工具调用
  2. 蛞蝓分组 --相关会话(计划/执行转换共享一个slug)合并为一行,其中包含聚合的统计数据和由分隔符行分隔的合并历史视图
  3. 子代理可见性 --历史视图中具有类型、状态和嵌入式转录渲染的完整代理树
  4. 实时关注模式 --历史观在新的转折到来时源源不断;向上滚动到锁定位置, G 重新启用
  5. 插件和内存检查 --跳转到插件(p)或记忆(m)从任何角度来看,国家都是为了 esc-恢复
  6. 详细视图 --扩展内容,包括思维块、工具调用输入/输出和每个模型的令牌计数
  7. 使用情况监视器 — █░ 信息面板上方显示的带有重置倒计时的5小时和7天Claude Max令牌窗口的进度条;未找到凭据时自动隐藏

入门指南

安装最新版本:

curl -fsSL https://raw.githubusercontent.com/Curt-Park/claudeview/main/install.sh | bash

或者从源代码构建:

git clone https://github.com/Curt-Park/claudeview.git
cd claudeview
make install

然后运行 claudeview 从项目视图开始,或 claudeview --demo 使用合成数据。要自行更新到最新版本,请执行以下操作:

claudeview --update

数据模型

claudeview直接从Claude Code的本地存储中读取:

~/.claude/projects/<hash>/
├── <session-id>.jsonl              main agent transcript
└── <session-id>/subagents/
    └── agent-<id>.jsonl            subagent transcripts
~/.claude/plugins/                  plugin metadata
~/.claude/settings.json             MCP server config

转录解析是增量和基于偏移量的——每次滴答声只读取新字节,即使有大型会话文件,也能保持仪表板的响应。

发展

建议的设置使用 布置 用于工具管理。克隆后, mise trust && mise install 处理Go和linter设置。主要目标:

make build    # build binary
make test     # run tests with race detector
make lint     # golangci-lint
make demo     # build and run demo mode

有关完整的UI规范、键绑定和列定义,请参阅 docs/ui-spec.md.内部文件 docs/ 通过以下方式与代码库保持同步 自传体学.

许可证

麻省理工学院