Claude Code status line

claude-scope

A dependency-free status line with multiple widgets and themes.

Install

npx -y claude-scope@latest install

From source

git clone https://github.com/YuriNachos/claude-scope.git

From the README

# claude-scope

  ### Real-time statusline for Claude Code CLI

  Track context, cost, git, docker, and more — right in your terminal

  Quick Start · Features · Themes · Configuration · Docs

  claude-scope in action — model, context, cost, git, docker, system metrics and more

🚀 Quick Start

This single command:
1. ✅ Adds statusLine to ~/.claude/settings.json
2. ✅ Opens interactive configurator to choose layout, theme, and style

Restart Claude Code — done!

💡 Why claude-scope?

claude-scope transforms your Claude Code CLI into a powerful command center. See everything you need at a glance:

✨ Highlights

- 🪶 Zero runtime dependencies — pure TypeScript, native Node.js only
- 🧩 15 customizable widgets — model, context, cost, git, docker, sysmon, and more
- 🎨 17 built-in themes — from Dracula to Nord to Cyberpunk
- 🎭 12 display styles — balanced, playful, compact, verbose, technical...
- 🤖 AI-friendly configuration — just ask Claude to customize it!
- ⚡ Instant setup — one command, works immediately

🧩 Features

Available Widgets

📐 Layout Presets

🎨 Themes

  Same data, different themes — find your style

17 Built-in Themes

Switch themes instantly:

⚙️ Configuration

🤖 /scope — AI-Powered Configuration

claude-scope includes a built-in Claude Code skill for effortless configuration. Just type /scope or ask naturally:

  Configure widgets with natural language — no manual editing needed

Use the /scope command:

Or just ask Claude naturally:

The skill is installed automatically with the package — no setup required!

Changes apply instantly on the next status line update.

📝 Manual Configuration

Edit ~/.claude-scope/config.json directly:

See AI-CONFIG-GUIDE.md for complete reference.

📚 Documentation

📋 Requirements

- Node.js 18+
- Claude Code CLI

🤝…

Read the full README on GitHub

How status lines work

A status line is a command Claude Code runs to draw the bar under the prompt. It gets the session as JSON on stdin (model, folder, cost, context) and prints one or more lines.
Point the statusLine setting in ~/.claude/settings.json at it: { "statusLine": { "type": "command", "command": "<the command from the README>" } }.
Or run /statusline inside Claude Code and describe what you want.

Claude Code docs