abtop TUI完全上手：5大核心面板全解析，Token统计与上下文窗口一目了然

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/abtop

abtop是一款面向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. 启动 TUI：

abtop

3.（可选）配置速率限制采集钩子：

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）。

┌─ ¹context：Token 速率曲线 + 各会话上下文窗口条 ────────┐ ├─ ²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 --setup，Codex 则需先跑过一次codex；
• 底部一行汇总所有会话的总 Token 量与当前 Token/分钟速率。

3️⃣ tokens 面板：Token 统计四维拆解

选中会话的 Token 明细（src/ui/tokens.rs），每项都带占比条：

下方还有按轮次的 Token 迷你曲线+ 总轮数 + 平均每轮消耗（如25k/t），快速判断哪个会话是"Token 黑洞"。

4️⃣ projects 面板：多项目 Git 状态速览

按项目去重后展示当前分支与改动统计（src/ui/projects.rs）：main +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、内存、轮数等。状态检测非常直观：

下半：选中会话详情。默认展示最近对话记录；宽终端（≥120 列）下左右分栏显示子进程（PID + 命令 + 端口）与 Subagents 树；按l可切换到工具调用时间线，按f切换文件读写审计：

⌨️ 选中会话后按Enter，abtop 会自动跳转（聚焦）到运行该 Agent 的终端，支持tmux、iTerm2、cmux（src/jump/ 目录下为各后端适配器）。

五、常用快捷键清单

六、个性化：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 同时是一个 Rust 库 crate（src/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