claude-code-statusline

🥈Silver

@rz1989s

Claude Code Statusline enhances terminal workflows with real-time cost tracking, MCP monitoring, and prayer times. It benefits developers and operations teams by providing flexible layouts and beautiful themes for improved productivity and situational awareness.

424210Updated 2w ago

Intermediate30min to implementautomation

Saves ~30 min per use

Quick InstallView Source

git clone https://github.com/rz1989s/claude-code-statusline.git

Works with:

Claude

Overview

About This Skill

How to Use

[{"step":"Install claude-code-statusline in your terminal tool (Neovim, tmux, or iTerm2). For Neovim, use your plugin manager (e.g., `Plug 'claude-ai/statusline'`). For tmux, clone the repo and source the script in your `.tmux.conf`.","tip":"Check the [official documentation](https://github.com/claude-ai/statusline) for tool-specific installation instructions."},{"step":"Configure the statusline by creating a config file (e.g., `~/.config/statusline/config.json`) with your project name, currency, MCP service, and location. Use the prompt template above to generate the initial config.","tip":"Use `jq` to validate your JSON config: `cat config.json | jq .`"},{"step":"Select a theme from the built-in options (e.g., 'solarized', 'dracula') or create a custom theme by defining colors in your config. Test the theme in your terminal.","tip":"Preview themes with `claude-statusline --preview --theme dracula` before applying."},{"step":"Add the statusline to your shell prompt or editor statusbar. For Neovim, add `require('statusline').setup()` to your `init.lua`. For tmux, add `source-file ~/.config/statusline/tmux/statusline.tmux` to your `.tmux.conf`.","tip":"Restart your terminal or editor after configuration changes to see updates."},{"step":"Monitor the statusline in real-time. The cost tracker updates with each API call, and prayer times refresh daily. Use the MCP status to debug connection issues.","tip":"For debugging, run `claude-statusline --debug` to log statusline updates to a file."}]

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/rz1989s/claude-code-statusline

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Generate a custom statusline configuration for [TOOL_NAME] (e.g., Neovim, tmux, or iTerm2) using claude-code-statusline. The statusline should display: 1) Current [PROJECT_NAME] Git branch and commit status, 2) Real-time [CURRENCY] cost tracking for Claude Code API usage this session, 3) [MCP_SERVICE] MCP server connection status, 4) [LOCATION] prayer times for today (Fajr, Dhuhr, Asr, Maghrib, Isha). Use the [THEME_NAME] theme (e.g., 'solarized', 'dracula', 'gruvbox') and ensure the layout is optimized for a [WIDTH]px terminal width. Include a fallback for when prayer times are unavailable.

Example Output

```json
{
  "statusline_config": {
    "tool": "Neovim",
    "project": "claude-docs-2024",
    "currency": "USD",
    "mcp_service": "claude-code-mcp",
    "location": "Istanbul, TR",
    "theme": "solarized",
    "width": 120,
    "sections": {
      "left": [
        {"type": "git_branch", "format": " {branch}%{?"},
        {"type": "git_status", "format": "%{modified}%{added}%{removed}"},
        {"type": "cost_tracker", "format": " $%.2f", "currency": "USD"}
      ],
      "right": [
        {"type": "mcp_status", "format": "󰚩 {status}", "service": "claude-code-mcp"},
        {"type": "prayer_times", "format": " {fajr} {dhuhr} {asr} {maghrib} {isha}", "location": "Istanbul, TR", "fallback": " N/A"},
        {"type": "theme_indicator", "format": " {theme}"}
      ]
    }
  },
  "theme_example": {
    "solarized": {
      "bg": "#073642",
      "fg": "#93a1a1",
      "git_branch": "#268bd2",
      "modified": "#b58900",
      "added": "#859900",
      "removed": "#dc322f",
      "cost_tracker": "#6c71c4",
      "mcp_status": {"connected": "#859900", "disconnected": "#dc322f"},
      "prayer_times": "#cb4b16"
    }
  }
}
```

### Example Statusline Output (Solarized Theme):
```
 main●1   $12.47  󰚩 ✔   05:12 12:45 15:58 18:12 19:45   solarized
```

### Explanation of Components:
- **Git Status**: Shows the current branch (`main`) with 1 modified file (`●1`).
- **Cost Tracker**: Displays real-time spending of $12.47 for the current session (assuming 1247 API calls at $0.01 each).
- **MCP Status**: Indicates the `claude-code-mcp` server is connected (`✔`).
- **Prayer Times**: Lists today's prayer times for Istanbul, formatted as `Fajr Dhuhr Asr Maghrib Isha`.
- **Theme Indicator**: Shows the active theme (`solarized`).

### Fallback Behavior:
If prayer times are unavailable (e.g., due to API failure), the statusline would display:
```
 N/A
```

### Customization Tips:
1. For **tmux**, wrap this in `#{...}` syntax (e.g., `#{git_branch}#{cost_tracker}`).
2. For **iTerm2**, use the `Powerline` font and configure the statusline via the shell prompt (e.g., `PROMPT='...${statusline}...'`).
3. Adjust the `currency` and `mcp_service` fields to match your actual setup.