abtop TUI完全上手5大核心面板全解析Token统计与上下文窗口一目了然【免费下载链接】abtopLike htop, but for AI coding agents. Monitor Claude Code Codex CLI sessions, tokens, context window, rate limits, and ports in real-time.项目地址: https://gitcode.com/gh_mirrors/ab/abtopabtop是一款面向AI coding agents的轻量级TUI 监控工具——就像 htop 之于进程abtop 让你在一块屏幕上实时看到所有 Claude Code、Codex CLI、OpenCode 会话的Token 用量、上下文窗口占用、速率限制配额以及开放端口。纯本地只读、无需 API Key支持 macOS、Linux 和 Windows。一、为什么你需要 abtop同时跑 3 个以上的 AI Agent 时你大概率会遇到这些问题 不知道各会话烧掉了多少 Token上下文快满了才发现 被速率限制卡住却不知道配额还有多久重置 Agent 起了个本地服务器忘了关端口一直占用孤儿端口 多个项目并行Git 分支和改动数量记不清。abtop 从本地进程与文件状态中发现会话src/collector/mod.rs 负责数据采集编排所有数据源均为只读不发起任何 API 调用、不上传任何数据隐私安全。二、快速上手3 步完成安装1. 安装最省事的方式是通过 Cargo 安装cargo install abtop 在 Linux 上建议安装sqlite3以启用 OpenCode 会话监控Windows 原生支持无需 WSL。2. 启动 TUIabtop3.可选配置速率限制采集钩子abtop --setup该命令会自动生成 scripts/abtop-statusline.sh 脚本并注册到 Claude Code 的 settings 中让 quota 面板能实时读到账户级配额详见下文。 推荐终端尺寸120×40或更大最小 60×18窗口不够宽时面板会优雅隐藏窄屏自动切换为标签页布局。三、TUI 总览5 大核心面板 会话主区abtop 的桌面布局从上到下为顶部信息栏 → ¹ context 面板 → 中部四连面板² quota / ³ tokens / ⁴ projects / ⁵ ports→ 底部 ⁶ sessions 主区。每个面板都能用数字键1–7单独显隐src/ui/view_menu.rs。┌─ ¹contextToken 速率曲线 各会话上下文窗口条 ────────┐ ├─ ²quota ────────┬─ ³tokens ──────┬─ ⁴projects ──┬─ ⁵ports ─┤ └─ ⁶sessions会话列表上 选中会话详情下───────────┘1️⃣ context 面板上下文窗口占用一目了然左侧是Token 速率的盲文点阵面积图200 点历史右侧是每个会话的上下文窗口占用条逻辑见 src/ui/context.rs 占用 ≥ 75% 显示!≥ 90% 变红并加⚠警告提前提示该会话快需要压缩/重启了窗口尺寸按模型硬编码如 Opus/Sonnet 为 200k[1m]变体为 1M显示C2等标记表示该会话已发生 N 次上下文压缩compaction。2️⃣ quota 面板速率限制配额倒计时中部左一展示Claude 与 Codex 双账户的 5 小时 / 7 天窗口配额剩余条并附带in 2h 15m这样的重置倒计时src/ui/quota.rs数据来自~/.claude/abtop-rate-limits.json超过 10 分钟未更新会判定为过期并降低显示亮度没配置过钩子时会提示你运行abtop --setupCodex 则需先跑过一次codex底部一行汇总所有会话的总 Token 量与当前 Token/分钟速率。3️⃣ tokens 面板Token 统计四维拆解选中会话的 Token 明细src/ui/tokens.rs每项都带占比条指标含义Input输入 TokenOutput输出 TokenCache Read缓存命中读取Cache Write缓存写入下方还有按轮次的 Token 迷你曲线 总轮数 平均每轮消耗如25k/t快速判断哪个会话是Token 黑洞。4️⃣ projects 面板多项目 Git 状态速览按项目去重后展示当前分支与改动统计src/ui/projects.rsmain 3 ~18表示新增 3 个文件、修改 18 个无改动显示✓ clean。多项目并行时再也不用来回git status。5️⃣ ports 面板孤儿端口侦探列出 Agent 子进程打开的监听端口及所属会话src/ui/ports.rs同一端口被多个会话占用会以红色 ⚠标出端口冲突父会话已退出但子进程仍在监听时端口进入ORPHAN PORTS区域按X一键结束所有孤儿端口有二次端口扫描 进程名校验的安全检查。四、sessions 主区会话状态与详情视图sessions 面板src/ui/sessions.rs是常驻主区分上下两部分上半会话列表表格。列宽随终端自适应包含 Agent 类型*CC/CD/#OC颜色区分、项目、AI 生成的一句话摘要、状态、模型、上下文百分比、累计 Token、内存、轮数等。状态检测非常直观状态图标含义 Working/Executing进程存活且转录文件 30 秒内有更新◌ Waiting存活但超过 30 秒无输出多半在等你输入✗ Error最近一条回复带有错误内容✓ Done进程已退出下半选中会话详情。默认展示最近对话记录宽终端≥120 列下左右分栏显示子进程PID 命令 端口与 Subagents 树按l可切换到工具调用时间线按f切换文件读写审计⌨️ 选中会话后按Enterabtop 会自动跳转聚焦到运行该 Agent 的终端支持tmux、iTerm2、cmuxsrc/jump/ 目录下为各后端适配器。五、常用快捷键清单按键功能按键功能↑/↓或k/j选择会话1–7显隐各面板Enter跳转到会话所在终端t切换主题x结束选中会话T子代理树视图X结束所有孤儿端口l/f时间线 / 文件审计视图r强制刷新Esc打开配置页q退出v视图菜单六、个性化12 套主题与语言配置按t运行时循环切换 12 套内置主题含 4 套色盲友好主题high-contrast、protanopia、deuteranopia、tritanopia及 light/white 亮色主题偏好会保存到~/.config/abtop/config.toml也可启动时指定abtop --theme dracula配置项还支持hidden_agents隐藏不用的 Agent、claude_config_dirs多 Claude profile 根目录、language zh中文界面默认跟随 LANG 自动检测。七、进阶玩法与实用参数命令用途abtop --once打印一次快照后退出适合脚本abtop --json输出单帧 JSON 快照方便二次开发abtop --mouse启用鼠标点击/滚轮导航默认关闭以保留终端拖选复制abtop 同时是一个 Rust 库 cratesrc/lib.rs、src/snapshot.rs本地工具可以直接复用其数据层并序列化与 TUI 相同的Snapshot状态。总结abtop 把 AI Agent 监控做成了终端里的任务管理器context 面板盯上下文、quota 面板盯配额、tokens 面板盯消耗、projects 面板盯 Git、ports 面板盯孤儿端口配合 sessions 主区的状态检测和一键跳转多 Agent 并行开发从此心里有数。纯本地只读、零配置门槛cargo install abtop一条命令即可开工强烈建议重度使用 Claude Code / Codex CLI 的同学常驻一个 tmux 面板。【免费下载链接】abtopLike htop, but for AI coding agents. Monitor Claude Code Codex CLI sessions, tokens, context window, rate limits, and ports in real-time.项目地址: https://gitcode.com/gh_mirrors/ab/abtop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
