/ Directory / Playground / ccstatusline
● Community sirmalloc ⚡ Instant

ccstatusline

by sirmalloc · sirmalloc/ccstatusline

A real statusline for Claude Code CLI — powerline-style, customizable widgets, real-time cost/usage tracking visible while you work.

ccstatusline replaces the bare prompt with a tmux/powerline-style statusline. Widgets show model, tokens spent, current cost, git branch, and more. Useful so you actually know what your session is costing.

Why use it

Key features

Live Demo

What it looks like in practice

ready

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "sirmalloc-ccstatusline": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/sirmalloc/ccstatusline"
      ],
      "_inferred": true
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "sirmalloc-ccstatusline": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/sirmalloc/ccstatusline"
      ],
      "_inferred": true
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "sirmalloc-ccstatusline": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/sirmalloc/ccstatusline"
      ],
      "_inferred": true
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "sirmalloc-ccstatusline": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/sirmalloc/ccstatusline"
      ],
      "_inferred": true
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "sirmalloc-ccstatusline",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/sirmalloc/ccstatusline"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json
{
  "context_servers": {
    "sirmalloc-ccstatusline": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/sirmalloc/ccstatusline"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add sirmalloc-ccstatusline -- git clone https://github.com/sirmalloc/ccstatusline

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use ccstatusline

See session cost as it accrues

👤 Claude Code users ⏱ ~15 min intermediate

When to use: You've been bitten by surprise bills.

Flow
  1. Install
    Add ccstatusline to your harness config.✓ Copied
    → Statusline visible
  2. Configure
    Pin cost + token widgets.✓ Copied
    → Cost tracked
  3. Work
    See costs grow in real time.✓ Copied
    → Better budgeting

Outcome: No more surprise Anthropic bills.

Combinations

Pair with other MCPs for X10 leverage

sirmalloc-ccstatusline + claude-code-safety-net

Statusline + safety hooks = better daily UX

Combine sirmalloc-ccstatusline with claude-code-safety-net: Statusline + safety hooks = better daily UX✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
statusline-widgets (see docs) Configurable widgets, not callable tools 1 call

Cost & Limits

What this costs to run

API quota
N/A
Tokens per call
0
Monetary
Free
Tip
Pick 3–4 widgets; more becomes noise

Security

Permissions, secrets, blast radius

Credential storage: None
Data egress: None

Troubleshooting

Common errors and fixes

Glyphs missing

Install a Nerd Font; powerline glyphs need them

Alternatives

ccstatusline vs others

AlternativeWhen to use it insteadTradeoff
Default promptYou don't mind a bare promptNo cost visibility

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills