slima4/claude-tui

A real-time statusline for Claude Code — context, cost, usage bars, sparkline, and live tool trace, right inside your session.

Website: slima4.github.io/claude-tui

---

Statusline

Compact mode — everything in one line:

claudetui mode compact

Full mode — three lines with context, session/weekly usage bars, sparkline, and live tool trace:

claudetui mode full

See the statusline README for the full feature list, customization (claudetui mode custom), widgets, color thresholds, and debugging flags.

---

Install

macOS (Homebrew)

brew tap slima4/claude-tui
brew install claude-tui
claudetui setup       # configure statusline, hooks, and commands

macOS / Linux (script)

curl -sSL https://raw.githubusercontent.com/slima4/claude-tui/main/install.sh | bash

Or clone and install locally:

git clone https://github.com/slima4/claude-tui.git && ./claude-tui/install.sh

Windows (WSL)

ClaudeTUI requires a Unix-like environment. On Windows, use WSL 2:

curl -sSL https://raw.githubusercontent.com/slima4/claude-tui/main/install.sh | bash

Install options

Both install.sh and uninstall.sh honor a few environment variables:

CLAUDETUI_PYTHON="$(uv python find 3.13)" ./install.sh   # pin an isolated Python (e.g. uv-managed 3.13); baked into the claudetui wrapper
INSTALL_DIR="$HOME/tools/claude-tui" ./install.sh        # install somewhere other than ~/.claude-ui
CLAUDE_UI_HOME="$HOME/tools/claude-tui" ./install.sh      # alias for INSTALL_DIR

Uninstall

claudetui uninstall
brew uninstall claude-tui

If you already ran brew uninstall first:

curl -sSL https://raw.githubusercontent.com/slima4/claude-tui/main/uninstall.sh | bash

---

More tools

ClaudeTUI ships a few companion utilities alongside the statusline. Each lives in its own directory with its own README:

Tool	What it does
claude-code-statusline	The statusline itself — full docs, widgets, color thresholds
claude-code-monitor	Live session dashboard for a second terminal — claudetui monitor
claude-code-sniffer	API call interceptor proxy — claudetui sniffer / claudetui sniff
claude-code-session-stats	Post-session analytics — claudetui stats
claude-code-session-manager	Browse, compare, resume, and export sessions — claudetui sessions list
claude-code-hooks	Hooks for automatic in-session context: hotspots, reverse deps, churn
claude-code-commands	Custom slash commands: /tui:session, /tui:cost, /tui:perf, /tui:context
claude_tui_core	Shared domain logic — models, pricing, network, settings
claude_tui_components	Shared UI library — progress bars, sparklines, widgets, colors

License

MIT