TbusOS

Sky Claude Hud — Development skill for Claude Code

Development community

A lightweight two-line statusline for Claude Code that works over SSH and in terminals like Xshell — pure Python stdlib, ANSI only, no GUI.

How to install Sky Claude Hud

This entry records only its repository, not the path inside it, so there is no exact command to give. Open TbusOS/sky-claude-hud and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Sky Claude Hud does

A lightweight two-line statusline for Claude Code that works over SSH and in terminals like Xshell — pure Python stdlib, ANSI only, no GUI.

Alternatives in Development

Check 1: Cache Exists? — CLAUDE_DIR="${CLAUDE_CONFIG_DIR:-$HOME/.claude}" CACHE_EXISTS=$(ls -d "$CLAUDE_DIR/plugins/cache/claude-hud" 2 10.9k ★
Opencove — Your infinite canvas workspace for agents, tasks, knowledge, and research 1.2k ★
Herdrm — Native macOS console for herdr — all your coding agents and their live terminals, across devices 635 ★

README

Sky Claude HUD

A lightweight statusline for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) that works over SSH and in terminals like Xshell. No GUI, no browser — just a compact two-line HUD rendered with ANSI escape codes.

一个轻量级的 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 状态栏，适用于 SSH 和 Xshell 等终端环境。无需 GUI 或浏览器，仅通过 ANSI 转义码渲染紧凑的两行 HUD。

Preview / 预览

◆ Claude Opus 4.6 │ ████████████░░░░░░░░ 58% │ $1.23 │ ⏱ 12m04s │ +42 -7
▸ ~/project │ ⎇ feat/my-branch │ ✱ modified │ 5h ████░░░░ 51% →18:44 │ 7d █░░░░░░░ 23% →05-03 16:34

**Line 1 / 第一行:** Model, context window usage bar, session cost, duration, lines changed

**Line 2 / 第二行:** Working directory, git branch & dirty state, API rate limit usage with next-reset time (`HH:MM` if today, `MM-DD HH:MM` if cross-day; a window is shown whenever Claude Code reports it, including `0%` right after a reset) / 速率限制百分比 + 下次重置时间（同日只显示 `HH:MM`，跨日显示 `MM-DD HH:MM`；只要 Claude Code 传了该窗口就显示，刚重置用量为 `0%` 时也显示）

Features / 特性

Zero dependencies — pure Python 3 stdlib, no pip install needed / 纯 Python 3 标准库，无需 pip 安装
SSH-friendly — ANSI colors only, works in Xshell, PuTTY, iTerm2, etc. / 仅使用 ANSI 颜色，适用于各种终端
Fast — single-shot stdin→stdout, no daemon, no polling / 单次 stdin→stdout，无守护进程
Color-coded bars — green/yellow/red thresholds for context and rate limits / 上下文和速率限制的绿/黄/红阈值
Git-aware — shows branch, staged, and modified status / 显示分支、暂存和修改状态

Requirements / 环境依赖

Dependency / 依赖	Version / 版本	Note / 说明
Python	>= 3.6	Uses f-strings and `subprocess.run` / 使用 f-string 和 `subprocess.run`
Git	any	Optional, for branch & dirty state detection / 可选，用于分支和状态检测
Claude Code	>= 1.0.x	Must support `statusLine` in `~/.claude/settings.json` / 需支持 statusLine 配置