claude-epic-status-line

KO | EN

gitlite — search

#hacktoberfest #ai #typescript #llm #golang #go #rust #deep-learning #nodejs #macos #windows #awesome #cli #mcp

claude-epic-status-line

(★ 11)

A feature-rich status line for Claude Code with colors, rate limits, git info, session cost, worktree detection, and auto-compact warnings

claude-epic-status-line 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Claude Epic Status Line

A feature-rich status line for [Claude Code](https://code.claude.com) that displays model info, context usage, git status, rate limits, session cost, and more — quiet when everything is healthy, loud exactly where something needs attention. Zero-config by default, deeply customizable when you want it (thresholds, palette, glyph sets, per-segment toggles).

📖 **[Full documentation](https://dsebastien.github.io/claude-epic-status-line/)** — [installation](https://dsebastien.github.io/claude-epic-status-line/install.html) · [usage](https://dsebastien.github.io/claude-epic-status-line/usage.html) · [configuration](https://dsebastien.github.io/claude-epic-status-line/configuration.html) · [tips](https://dsebastien.github.io/claude-epic-status-line/tips.html) · [troubleshooting](https://dsebastien.github.io/claude-epic-status-line/troubleshooting.html)

## What it looks like

### Watch the 70-second tour

[![Watch the Claude Epic Status Line video](https://raw.githubusercontent.com/dsebastien/claude-epic-status-line/master/docs/assets/claude-epic-status-line-poster.png)](docs/assets/claude-epic-status-line.mp4)

*Click to play, or [watch it on the documentation site](https://dsebastien.github.io/claude-epic-status-line/#see-it-in-action).*

### The status line itself

![Claude Epic Status Line screenshot](https://raw.githubusercontent.com/dsebastien/claude-epic-status-line/master/screenshot.png)

## Features

| Segment | Description |
|---------|-------------|
| **Model** | Short model name (e.g., `Opus 4.6` instead of `Claude Opus 4.6`) |
| **Context** | Usage percentage + token counts (e.g., `12% (42k/200k)`) with color coding |
| **Auto-compact warning** | Steady bold `⚠` when context usage >= 80% |
| **Directory** | Truncated to last 2 path components |
| **Git branch** | Branch name with detailed status: staged (`S:2`), unstaged (`U:1`), untracked (`A:3`) |
| **Git ahead/behind** | `⇡2⇣1` arrows showing commits ahead/behind upstream |
| **Worktree** | `⎇wt` indicator when running inside a git worktree |
| **Session cost** | `$X.XX` with configurable warn/critical thresholds and currency |
| **Session duration** | `5m`, `1h30m`, etc. |
| **Lines changed** | `+156/-23` cumulative lines added/removed |
| **Effort level** | `● high`, `◑ medium`, `◔ low` (from the session itself) |
| **Badges** | Subagent name, fast mode, thinking, vim, non-default output style, `⚠200k+` |
| **Rate limits** | `█░` progress bars for 5-hour, 7-day, per-model, and extra usage with reset times |

### Color coding

One escalation scale drives every percentage-based segment (context, rate bars) — quiet when healthy, then:

- **Yellow** — ≥ 70% (`CESL_WARN`)
- **Orange** — ≥ 80% (`CESL_HIGH`); context also gains a steady bold `⚠`
- **Red** — ≥ 90% (`CESL_CRIT`)

Session cost uses its own `CESL_COST_WARN`/`CESL_COST_CRIT` thresholds, and the model name is colored by model family (Opus, Sonnet, Haiku, Fable).

## Requirements

- `jq` — JSON parsing
- `curl` — fetching rate limit data from the Anthropic API
- `git` — branch and worktree detection

## Installation

### Quick install

```bash
git clone https://github.com/dsebastien/claude-epic-status-line.git
cd claude-epic-status-line
bash install.sh
```

### Manual install

1. Copy `statusline.sh` to `~/.claude/statusline-command.sh`
2. Add this to your `~/.claude/settings.json`:

```json
{
  "statusLine": {
    "type": "command",
    "command": "bash '/home/YOUR_USER/.claude/statusline-command.sh'"
  }
}
```

3. Restart Claude Code.

## Uninstall

```bash
bash uninstall.sh
```

Or manually remove the `statusLine` key from `~/.claude/settings.json` and delete `~/.claude/statusline-command.sh`.

## Configuration

Everything is optional — with zero config the status line renders its default design. Settings layer as: **script defaults < `~/.config/claude-epic-status-line/config.sh` < `CESL_*` environment variables** (environment wins).

`install.sh` scaffolds the config file with every knob present but commented out at its default value — open it to see what's tunable: escalation thresholds (`CESL_WARN`/`CESL_HIGH`/`CESL_CRIT`), cost thresholds, bar width, cache TTL, currency, glyph set (`unicode`/`nerd`/`ascii`), per-segment `CESL_SHOW_*` toggles, the full color palette, and per-model-family hues.

Debugging: pipe a status JSON through `statusline.sh explain` to see the raw input, every parsed value, the API/cache state, and your effective config.

### Theme recipes

Copy into your `config.sh`:

```bash
# Monochrome minimal — no hues, just states
CESL_COLOR_DIR='150;150;150'
CESL_COLOR_OPUS='200;200;200'
CESL_COLOR_SONNET='200;200;200'
CESL_COLOR_HAIKU='200;200;200'
CESL_COLOR_FABLE='200;200;200'
CESL_COLOR_MODEL='200;200;200'
```

```bash
# Wide dashboard — chunkier bars, ASCII-safe
CESL_BAR_WIDTH=20
CESL_GLYPHS=ascii
```

```bash
# Quiet mode — just model, context, and rate limits
CESL_SHOW_DIR=0
CESL_SHOW_COST=0
CESL_SHOW_DURATION=0
CESL_SHOW_LINES=0
CESL_SHOW_EFFORT=0
CESL_SHOW_BADGES=0
CESL_SHOW_GIT=0
```

## How it works

The script receives JSON from Claude Code via stdin with session data (model, context window usage, cwd, cost, effort, rate limits, etc.). The stdin payload is parsed in a single `jq` call for performance (auxiliary data — cache validation, API enrichment — uses separate small jq invocations), then the status line segments are assembled.

The 5-hour and 7-day rate-limit bars come straight from that stdin data (Claude Code ≥ 2.1.140 recommended). The Anthropic usage API is queried only as enrichment — extra-usage credits and per-model weekly limits — using your OAuth token (resolved from `CLAUDE_CODE_OAUTH_TOKEN`, `~/.claude/.credentials.json`, `secret-tool` on Linux, or macOS Keychain), cached in a per-user directory for `CESL_CACHE_TTL` seconds (60 by default). No token? Those rows simply don't render.

## Platform support

Works on Linux and macOS (bash 3.2+, BSD or GNU userland). Date formatting and credential resolution adapt automatically to the platform. Git and keychain lookups are bounded to ~2 seconds — via `timeout(1)` where available, or a built-in fallback on stock macOS — so a huge repository can never freeze your status line.

## Documentation

The full guide lives at **[dsebastien.github.io/claude-epic-status-line](https://dsebastien.github.io/claude-epic-status-line/)**, and its sources are in [`docs/`](docs/):

| Page | Covers |
|------|--------|
| [Overview](docs/README.md) | What it is, the video, key features |
| [Installation](docs/install.md) | Requirements, quick and manual install, upgrading, uninstalling |
| [Usage](docs/usage.md) | Every segment explained, the rate-limit dashboard, the `explain` subcommand |
| [Configuration](docs/configuration.md) | Every `CESL_*` knob with its default |
| [Tips & best practices](docs/tips.md) | Theme recipes, threshold tuning, parallel sessions |
| [Troubleshooting](docs/troubleshooting.md) | When something does not render |
| [Release notes](docs/release-notes.md) | What changed, and breaking changes |

## Support

If you find this useful, consider [buying me a coffee](https://www.buymeacoffee.com/dsebastien).

Check out my other projects at [dsebastien.net](https://dsebastien.net).

## Credits

Inspired by [kamranahmedse/claude-statusline](https://github.com/kamranahmedse/claude-statusline).

## License

MIT

claude-epic-status-line

claude-epic-status-line 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

claude-epic-status-line

claude-epic-status-line 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README