工程开发
context-bar avatar

context-bar

为 Claude Code 状态列提供实时彩色上下文使用进度条,并支持手动即时检查功能。

简介

context-bar 技能为在 Claude Code 环境中工作的开发人员提供了一项重要的可观测性工具:实时、彩色编码的当前上下文窗口消耗视觉表示。通过直接整合到命令行状态列中,它消除了对 Token 限制的猜测,使开发人员无需中断工作流即可持续监控资源占用。该视觉化系统采用清晰的阈值机制——绿色代表高效率使用(低于 50%),琥珀色代表中等使用(50-79%),红色代表临界水位(80% 以上),从而能够主动管理长时间运行的会话、复杂的调试任务或大型代码库交互。

  • 直接在 Claude Code 状态列接口中实时视觉化显示 Token 使用百分比。

  • 采用颜色编码警报,在风险发生前标示潜在的上下文溢出风险,有助于防止输出截断或性能下降。

  • 通过 /context-bar 斜线指令进行按需检查,在不影响终端记录的情况下提供快速快照。

  • 与现有的 Claude Code 设置无缝整合,支持项目层级或用户层级配置。

  • 支持显示其他会话元数据,包括当前的 Git 分支与工作目录状态。

  • 此工具专为频繁处理大型项目的开发人员、软件工程师与 AI 代理操作员所设计。

  • 用户应确保环境已正确设置提供的 Shell 脚本,以确保状态列在每次交互后皆能准确更新。

  • 这是一个轻量级的监控工具,依赖内部 Claude Code 的状态追踪机制 (context_window.used_percentage) 以确保最高准确度。

  • 该技能作为状态插件运行,不涉及繁重的数据处理,而是作为维持会话健康与避免密集开发周期中因上下文窗口溢出导致错误的必要诊断覆盖层。

仓库统计

Star 数
1
Fork 数
1
Open Issue 数
10
主要语言
Python
默认分支
main
同步状态
空闲
最近同步时间
2026年5月3日 21:54
在 GitHub 查看