Install and manage Claude Code components (status line, hooks, etc.)
Project description
Claude Code Setup
A personal Claude Code configuration toolkit. Each component is self-contained and installs into ~/.claude with a single command. Currently includes a status line that replaces the default bottom bar with a richer, information-dense display.
Components
| Component | Description |
|---|---|
statusline |
5-row status bar showing git state, context usage, session cost, rate limits, and last message |
Installation
uvx claude-code-setup
Restart Claude Code after installing. The status bar appears at the bottom of the interface.
No
uv? Install it withcurl -LsSf https://astral.sh/uv/install.sh | sh
Install a specific component:
uvx claude-code-setup statusline
Uninstall:
uvx claude-code-setup --uninstall
What's included
Status line
A 5-row bar at the bottom of Claude Code showing everything useful at a glance.
Color coding: green = healthy · amber = needs attention · red = critical.
| Row | Label | Always shown? | Content |
|---|---|---|---|
| 1 | Session |
Yes | Model, session, directory, git branch, effort, vim mode |
| 2 | Git |
In git repos | Staged / modified / untracked counts, ahead/behind remote, stash, last commit |
| 3 | Context |
Yes | Context bar, token count, cache hit rate, cost, duration, API wait, lines changed |
| 4 | Limits |
Pro/Max only | 5-hour and 7-day rate limit usage with reset countdowns, Claude Code version |
| 5 | Message |
When available | Last user message (from transcript), truncated to 100 chars |
See what every field means:
uv run ~/.claude/statusline.py --help
Development
Set up the dev environment:
just setup
Run checks locally before committing:
just lint # Check code style
just format # Auto-fix code style
just typecheck # Type checking
just test # Run tests
just check # Run all checks (lint + typecheck + test)
Pre-commit hooks automatically run on every commit. Install them with:
pre-commit install
CI/CD — GitHub Actions automatically runs tests and linting on every PR to main.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file claude_code_setup-0.1.2.tar.gz.
File metadata
- Download URL: claude_code_setup-0.1.2.tar.gz
- Upload date:
- Size: 196.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.5.26
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d5fe3aa8206e12f1aae212aa6c9a09e69b1cf544d178a0dd8f9f2833dc66305e
|
|
| MD5 |
48f43ce7f815cd1553a2884f97ee1c58
|
|
| BLAKE2b-256 |
2a968557ad19e29501a4737f5b82eea13965f2e2a1471b9896114ebe543c2387
|
File details
Details for the file claude_code_setup-0.1.2-py3-none-any.whl.
File metadata
- Download URL: claude_code_setup-0.1.2-py3-none-any.whl
- Upload date:
- Size: 18.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.5.26
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ebd4508db615c335a93fe483e84f9d6cafd7dc9fdba1c076811a3142227a43c0
|
|
| MD5 |
cb904c8d0a452200882716527ce815f2
|
|
| BLAKE2b-256 |
a5cfa618d9e7f80f06f47e91f6a794a4efdcf2dc7b9c4f15355b8b84845cad0c
|