Skip to main content

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 with curl -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.

Statusline screenshot

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)

Source distribution for claude-code-setup 0.1.2
File Size Uploaded
claude_code_setup-0.1.2.tar.gz 196.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for claude-code-setup 0.1.2
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page