2026-09-30 17:02:47 +02:00

Claude Code configuration

My personal ~/.claude, version controlled: CLAUDE.md and AGENTS.md for instructions, the words under CLAUDE.md → "Vocabulary"; agents/ and skills/; principles/ for what the reviewer agents hold every project to; docs/ for decisions; settings.json for the harness and .claude/settings.json for the harness inside this repo; CHANGELOG.md and todo.md; the tools in bin/; and workflow-bench/, the scripts and prompts of the 2026-09-30 bench of larv-review.

Goals

  1. Make my claude setup shareable between computers.
  2. Keep my claude setup and the transcripts of unattended runs, backed up.
  3. Leak nothing to the remote — no credentials, no transcripts, no memory files.
  4. Get the highest quality out of Claude Code while interrupting me the least, so development scales.
    1. Proven, stellar output quality: code, documentation and plans.
    2. Decide by the project's goals when confident; ask me when not, and never the same thing twice.
    3. The same rules in every project and every session.
    4. Add cost only where it meaningfully raises quality; otherwise work to lower cost.
    5. Delivery speed.

Audience

Me, on my own machines, which take tagged releases. Nobody else depends on it.

Install

Check out the latest tag in ~/.claude, with Python 3.11 or newer as python3 on PATH, and for Rust projects rust-analyzer on PATH, which the rust-analyzer-lsp plugin needs. Install every plugin settings.json enables:

claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install claude-security@claude-plugins-official
claude plugin install code-review@claude-plugins-official
claude plugin install rust-analyzer-lsp@claude-plugins-official

Link loop-claude onto PATH: ln -s ~/.claude/bin/loop-claude ~/.local/bin/loop-claude. Run loop-claude only in a sandbox with no direct access to a production environment, such as a dedicated VM: every claude it starts, the interrupt included, skips every permission prompt.

Release

Rename ## Unreleased in CHANGELOG.md to the version, commit, and tag that commit v<version>.

Tools

  • loop-claude <task> runs a project's next chunk cycle after cycle; loop-claude --help states its contract.
  • rank_todo.py [--check] [todo.md] scores and ranks a project's todo.md; rank_todo.py --help states the format.
  • statusline.py renders Claude Code's status line; settings.json → statusLine runs it.

Test on the host, with uv on PATH to fetch mypy and the Python version Install names (docs/decisions.md → bin/): python3 -m unittest discover -s bin -p 'test_*.py'

Tracking a new file

.gitignore is an allowlist. Track a file by negating it and its parent directories, then confirm with git check-ignore -v <path>:

!docs/
!docs/*.md
S
Description
Authored half of ~/.claude: instructions, agents, skills, principles, settings
Readme 53 MiB
Languages
Python 97.6%
HTML 2.3%