Owloops/claude-powerline

Claude Powerline – 为 Claude Code 提供的状态栏

是什么

• 一个基于 Node 的插件，为 Anthropic 的 Claude 模型桌面 UI Claude Code 添加 Vim 风格的「powerline」状态栏。
• 状态栏位于编辑器底部，实时显示当前 Claude 会话、Git 仓库、文件系统以及使用相关指标（令牌、成本、速率限制窗口等）的信息。

为何重要

• Claude Code 已经报告了大量遥测数据（模型名称、上下文窗口、速率限制数据）。Powerline 将这些数据转化为紧凑且始终可见的摘要，帮助开发者无需打开独立面板即可监控令牌消耗、日/月预算以及 Git 状态。
• 该工具完全可配置——您可以选择显示哪些段落，选择视觉样式（经典 powerline、胶囊、极简或全屏 TUI），切换主题，甚至定义自定义 JSON 配置。

主要功能（如 README 所述）

功能	你将获得
实时使用追踪	显示已使用的令牌数、估算成本、日/月总计，以及视觉化的「预算」指示器。
Git 集成	分支名称、SHA、ahead/behind 箭头、暂存区计数和工作树标记。
模型与会话信息	当前 Claude 模型、会话 ID，以及可选的扩展思考状态。
上下文窗口可视化器	显示模型上下文窗口的使用百分比，支持多种条形样式（文本、块、点等）。
速率限制窗口	显示 Claude 的 5 小时「区块」和 7 天「周」利用率，支持可选的节奏对比。
指标	API 响应时间、会话总时长、消息数量、新增/删除行数。
Tmux 识别	在 tmux 中运行 Claude Code 时，显示 tmux 会话名称。
主题与样式	内置六种主题（深色、浅色、nord、tokyo-night、rose-pine、gruvbox）和四种视觉样式；您也可以创建自定义主题。
零运行时依赖	npm 包以单个脚本形式分发，通过 npx 自动获取更新。
配置	支持项目本地、用户级别、XDG 的 JSON 配置文件，修改后自动重载；CLI 标志和环境变量可覆盖配置。
Powerline Studio	一个 Web UI（powerline.owloops.com），支持拖拽段落、预览样式，并导出生成的 JSON 配置。

如何获取

1. 前置条件 – Node 18+、Claude Code、Git 2.0+，以及推荐使用 Nerd Font 以获得最佳 Unicode 符号显示。
2. 安装 – 在 Claude Code 内部运行内置向导（/plugin marketplace add Owloops/claude-powerline … /powerline），或在 settings.json 中添加一条调用 npx @owloops/claude-powerline 的命令条目。
3. 配置 – 再次运行 /powerline 以重新打开向导，或手动编辑生成的 ~/.claude/claude-powerline.json。您也可以使用在线 Powerline Studio 创建配置并粘贴回。

典型使用场景 一位使用 Claude Code 的开发者希望随时了解项目中的令牌消耗情况。通过启用 Session 和 Today 段，状态栏将显示类似 § 4.4M tokens $12.34 (79%) 的信息，并在每次交互后自动更新。同时，Git 段持续显示当前分支和 ahead/behind 状态，使开发者在代码与 AI 协助之间迭代时始终掌握上下文。

谁可能用得上

• 任何使用 Claude Code 进行代码生成、调试或文档编写，需要监控令牌使用并控制预算的人。
• 希望在团队成员间统一 Git 状态和 AI 辅助工作视觉提示的团队。
• 喜欢高度可定制状态栏（类似 Vim/Neovim 的 powerline 插件）但又在 GUI 编辑器中使用的高级用户。

---

以上所有细节均直接取自项目 README；未推断任何额外功能。