{"id":50727155,"url":"https://github.com/fahimfba/claudecode-statusline","last_synced_at":"2026-06-10T05:01:32.822Z","repository":{"id":355072157,"uuid":"1226646964","full_name":"FahimFBA/claudecode-statusline","owner":"FahimFBA","description":"Nice and useful statusline for Claude Code","archived":false,"fork":false,"pushed_at":"2026-05-01T17:36:39.000Z","size":283,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-01T19:22:00.308Z","etag":null,"topics":["claude-code","claude-code-plugin","claude-code-status-line","claude-code-statusline"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FahimFBA.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-01T17:00:32.000Z","updated_at":"2026-05-01T17:36:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/FahimFBA/claudecode-statusline","commit_stats":null,"previous_names":["fahimfba/claudecode-statusline"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/FahimFBA/claudecode-statusline","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FahimFBA%2Fclaudecode-statusline","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FahimFBA%2Fclaudecode-statusline/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FahimFBA%2Fclaudecode-statusline/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FahimFBA%2Fclaudecode-statusline/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FahimFBA","download_url":"https://codeload.github.com/FahimFBA/claudecode-statusline/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FahimFBA%2Fclaudecode-statusline/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34137570,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","claude-code-plugin","claude-code-status-line","claude-code-statusline"],"created_at":"2026-06-10T05:01:30.546Z","updated_at":"2026-06-10T05:01:32.816Z","avatar_url":"https://github.com/FahimFBA.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# claudecode-statusline\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"img/preview.png\" alt=\"claudecode-statusline preview\" width=\"720\"/\u003e\n\u003c/p\u003e\n\nA one-command setup for a richly decorated Claude Code statusline with [Caveman mode](https://github.com/JuliusBrussee/caveman) baked in. Interactive installer lets you pick all components or only the ones you want.\n\n## What you get\n\n```\n[🪨 CAVEMAN] │ 📁 my-project 🌿 main │ 🤖 Claude Sonnet 4.6 │ CTX ████░░░░ 42% │ ⚡ ▄ MEDIUM │ 5h ████░░░░ 42% used 58% rem ↺ 1h 22m │ 7d ██░░░░░░ 85% used 15% rem ↺ 3d 7h\n```\n\n| Segment | Description |\n|---|---|\n| `🪨 CAVEMAN` | Active caveman mode (hidden when off) |\n| `📁 project 🌿 branch` | Project folder name + git branch |\n| `🤖 Claude Sonnet 4.6` | Current model name |\n| `CTX ████░░░░ 42%` | Context window usage bar (green → yellow → red) |\n| `⚡ ▄ MEDIUM` | Effort level with fill icon (only when model supports it) |\n| `5h ████░░░░ 42% used 58% rem ↺ 1h 22m` | Hourly rate limit: spent + remaining % + time until reset |\n| `7d ██░░░░░░ 85% used 15% rem ↺ 3d 7h` | Weekly rate limit: spent + remaining % + time until reset |\n\nRate limit bars use color-coded severity for both values:\n- **Used %** — green (low) → yellow (mid) → red (high usage)\n- **Rem %** — green (plenty left) → yellow → red (almost none left)\n\n## Prerequisites\n\n| Requirement | Install |\n|---|---|\n| [Claude Code](https://claude.ai/code) | Download from claude.ai/code |\n| [Node.js](https://nodejs.org) LTS | `brew install node` / [nodejs.org](https://nodejs.org) |\n| `bash` (Windows only) | [Git for Windows](https://git-scm.com) or WSL |\n\n## Quick start\n\n### macOS / Linux\n\n```bash\ngit clone https://github.com/FahimFBA/claudecode-statusline.git\ncd claudecode-statusline\nchmod +x install.sh\n./install.sh\n```\n\nThen restart Claude Code.\n\n### Windows (PowerShell)\n\n```powershell\ngit clone https://github.com/FahimFBA/claudecode-statusline.git\ncd claudecode-statusline\npowershell -ExecutionPolicy Bypass -File install.ps1\n```\n\nThen restart Claude Code.\n\n## Interactive installer\n\nWhen you run the installer it will ask:\n\n```\nHow do you want to install?\n\n  1) Full install  -- all components, replaces existing statusline\n  2) Custom        -- choose which components to include\n\nChoice [1/2, default=1]:\n```\n\nIf you choose **2**, you'll see a numbered menu:\n\n```\nAvailable components:\n\n  1) Caveman badge      🪨 CAVEMAN:FULL\n  2) Project + branch   📁 my-project 🌿 main\n  3) Model name         🤖 Claude Sonnet 4.6\n  4) Context window     CTX ████░░░░ 42%\n  5) Effort level       ⚡ ▄ MEDIUM\n  6) Hourly limit (5h)  5h ████░░░░ 42% used · 58% rem ↺ 1h 22m\n  7) Weekly limit (7d)  7d ██░░░░░░ 85% used · 15% rem ↺ 3d 7h\n  8) Token savings      🪨 ~42% tokens saved\n\nNumbers to include (e.g. 2 3 4 6 7), or 'all' [default=all]:\n```\n\nEnter the numbers you want separated by spaces. Your existing `statusLine` in `settings.json` is shown before you choose, so you can decide whether to replace it or build a custom one.\n\n## What the installer does\n\n1. Copies hook scripts to `~/.claude/hooks/`\n2. Merges settings into `~/.claude/settings.json` (backs up existing file first)\n3. Installs the Caveman plugin via `claude plugins install caveman --marketplace caveman`\n\nExisting settings are **merged**, not overwritten — your other config survives.\n\n## Caveman mode commands\n\n| Command | Effect |\n|---|---|\n| `/caveman` | Activate full mode |\n| `/caveman lite` | Lite mode (fewer drops) |\n| `/caveman ultra` | Ultra compressed |\n| `/caveman off` | Deactivate |\n| `stop caveman` | Natural language deactivate |\n| `/caveman-stats` | Token usage + savings this session |\n| `/caveman-stats --all` | Lifetime stats across all sessions |\n\n### Intensity levels\n\n| Level | Behaviour |\n|---|---|\n| `lite` | Drop articles and filler, keep sentence structure |\n| `full` | Fragments OK, short synonyms, caveman pattern |\n| `ultra` | Maximum compression, minimal connectives |\n\n## Files\n\n```\nclaudecode-statusline/\n├── hooks/\n│   ├── caveman-activate.js      # SessionStart hook — activates caveman mode\n│   ├── caveman-config.js        # Shared config resolver + safe flag I/O\n│   ├── caveman-mode-tracker.js  # UserPromptSubmit hook — tracks mode changes\n│   ├── caveman-stats.js         # Token usage stats engine\n│   ├── caveman-statusline.sh    # Statusline renderer (bash)\n│   └── package.json             # CommonJS marker\n├── settings.template.json       # Reference settings (paths replaced by installer)\n├── install.sh                   # macOS / Linux installer\n├── install.ps1                  # Windows PowerShell installer\n└── README.md\n```\n\n## Customising the statusline\n\nRe-run the installer and choose option 2 to pick which components to show.\n\nOr edit `~/.claude/hooks/caveman-statusline.sh` directly after install. The `append` function controls segment order — comment out any segment you don't want.\n\nEach component can also be toggled via environment variables in the statusLine command (the installer writes these automatically when you use option 2):\n\n| Env var | Default | Hides |\n|---|---|---|\n| `SL_CAVEMAN=0` | on | Caveman badge |\n| `SL_PROJECT=0` | on | Project + branch |\n| `SL_MODEL=0` | on | Model name |\n| `SL_CTX=0` | on | Context window bar |\n| `SL_EFFORT=0` | on | Effort level |\n| `SL_5H=0` | on | Hourly rate limit |\n| `SL_7D=0` | on | Weekly rate limit |\n| `SL_SAVINGS=0` | on | Token savings |\n\nTo change caveman default mode, set the environment variable before starting Claude Code:\n\n```bash\nexport CAVEMAN_DEFAULT_MODE=lite   # lite | full | ultra | off\n```\n\nOr create `~/.config/caveman/config.json`:\n\n```json\n{ \"defaultMode\": \"lite\" }\n```\n\n## Uninstall\n\nRemove the hook scripts:\n\n```bash\nrm ~/.claude/hooks/caveman-*.js ~/.claude/hooks/caveman-statusline.sh\n```\n\nRemove the `hooks`, `statusLine`, `enabledPlugins`, and `extraKnownMarketplaces` keys from `~/.claude/settings.json`.\n\n## Credits\n\n- [Caveman plugin](https://github.com/JuliusBrussee/caveman) by JuliusBrussee — the underlying caveman mode engine\n- Statusline and installer by [FahimFBA](https://github.com/FahimFBA)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffahimfba%2Fclaudecode-statusline","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffahimfba%2Fclaudecode-statusline","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffahimfba%2Fclaudecode-statusline/lists"}