orassayag/super-status

7 stars · Last commit 2026-10-01

A Bash statusline for Claude Code: model, git state, context window, 5-hour and weekly plan limits, subscription cycle, cost, tokens, cache ratio, LOC, plus live tool, subagent and todo activity in compact labeled lines. Subscription, API-key, Bedrock, Vertex and OpenRouter backends; JSON config for presets, layouts, colors and thresholds.

README preview

# super-status

A unified statusline for **Claude Code** and **Google Antigravity CLI (`agy`)** — identity, active agents, context usage, session quality, plan-limit tracking, and (optionally) live tool activity, running subagents, todo progress, and `/orca`/`/master` wave state, in a compact, visually hierarchical layout at the bottom of every session.

![Screenshot](images/demo.png)

## Requirements

Supported platforms: **macOS**, **Linux**, and Windows via **WSL** or **Git Bash** (plain Windows without a bash environment is not supported — this is a bash script by design).

| Binary | Required? | Used for |
|---|---|---|
| `bash` | required | the script itself |
| `jq` | required | stdin/config JSON parsing |
| `python3` | required | transcript parsing (`Tok`, `Calls`, `Activity:`, `Agents:`, `Todo:`) — ships by default on macOS and most Linux distros |
| `git` | recommended | branch, dirty/ahead-behind markers |
| `timeout` | recommended | the time limit on every `git`/`jj` call. GNU coreutils; on macOS it is `gtimeout` from `brew install coreutils`. Without either, git runs unbounded and a stalled repository can freeze the statusline |
| `tokei` | optional | the `LOC` (lines of code in project) field |
| `curl` | optional | the OpenRouter `Bal` bar (Mode 3 only) |
| `jj` | optional | [Jujutsu](https://github.com/jj-vcs/jj) branch state, behind `jj.enabled` (Mode: any) |

View full repository on GitHub →