Cc Poor Mans Statusline — AI skill for Claude Code

Poor Man's Statusline

Lightweight custom statusline for Claude Code with Powerline-style segments, usage limits, reset timers, and context monitoring.

Features

• Powerline-style segments with colored backgrounds and smooth arrow transitions
• Reset timers showing countdown AND absolute time until limits reset (e.g., "2h11m @ 10pm")
• Real-time API usage (5-hour and 7-day limits)
• Per-model availability (Opus and Sonnet with distinct colors)
• Context window monitoring with auto-compact warning
• 1-minute smart caching
• Automatically adapts to your Claude Pro tier (basic or higher)

Example Output

**Claude Pro (higher tiers with 7-day limits):**

 opus-4-5  project  main
 5h 27%  2h11m @ 10pm   7d 34%  4d2h @ Dec 2
 Opus 34%  Sonnet 20%

**Claude Pro (basic tier):**

 sonnet-4-5  project  main
 5h 45%  3h30m @ 2pm

**Color scheme:**

• Magenta: Model name, Opus limit
• Yellow: Project directory
• Green: Git branch
• Cyan: Usage percentages
• Blue: Reset countdowns, Sonnet limit
• Gray: Context info

Prerequisites

• Claude Code (installed and authenticated)
• jq - JSON processor
• curl - HTTP client
• Terminal with 256-color support

# macOS
brew install jq

# Ubuntu/Debian
sudo apt-get install jq

Installation

# 1. Clone the repository
git clone https://github.com/alexfazio/cc-poor-mans-statusline.git
cd cc-poor-mans-statusline

# 2. Make the script executable
chmod +x statusline.sh

3. Configure Claude Code

Add the statusline to your `~/.claude/settings.json`:

{
  "statusLine": {
    "type": "command",
    "command": "/path/to/cc-poor-mans-statusline/statusline.sh"
  }
}

Replace `/path/to/` with the actual location where you cloned the repo. For example:

• ~/Documents/GitHub/cc-poor-mans-statusline/statusline.sh
• ~/projects/cc-poor-mans-statusline/statusline.sh

**Tip:** You can also use `~` for your home directory in the path.

Your credentials at `~/.claude/.credential