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.
Metadata
Release files for claude-code-setup 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| claude_code_setup-0.1.2.tar.gz | 196.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| claude_code_setup-0.1.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 215.1 kB
Release files / claude_code_setup-0.1.2.tar.gz
| Download URL | claude_code_setup-0.1.2.tar.gz |
|---|---|
| Size | 196.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d5fe3aa8206e12f1aae212aa6c9a09e69b1cf544d178a0dd8f9f2833dc66305e
|
|
BLAKE2b-256 checksum How to use checksums |
2a968557ad19e29501a4737f5b82eea13965f2e2a1471b9896114ebe543c2387
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.5.26
|
Release files / claude_code_setup-0.1.2-py3-none-any.whl
| Download URL | claude_code_setup-0.1.2-py3-none-any.whl |
|---|---|
| Size | 18.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ebd4508db615c335a93fe483e84f9d6cafd7dc9fdba1c076811a3142227a43c0
|
|
BLAKE2b-256 checksum How to use checksums |
a5cfa618d9e7f80f06f47e91f6a794a4efdcf2dc7b9c4f15355b8b84845cad0c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.5.26
|