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; statusline.sh; CHANGELOG.md and todo.md; and the tools in bin/.
Goals
- Share this configuration between my computers.
- Keep it backed up.
- Leak nothing — no credentials, no transcripts, no memory files.
- Run work chunks unattended, interrupting me only when a decision is mine.
Audience
Me, on my own machines, which take tagged releases. Private repo, nobody else depends on it.
Install
Check out the latest tag in ~/.claude. Link the tool onto PATH: ln -s ~/.claude/bin/loop-claude ~/.local/bin/loop-claude.
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 --helpstates its contract.
Test: python3 -m unittest bin/test_loop_claude.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