Dot Claude

Claude Code config

PRB's personal Claude Code config, mounted at ~/.claude.

Quick Start

See Installation for full setup and Configuration for customization.

Installation

Prerequisites

- Bun: JS dependencies and Husky/lint-staged automation (bun install)
- Just: command runner for build scripts (brew install just)
- Python 3.15+ and uv: Python package/project manager

Setup

Verify

Configuration

Settings

All JSONC files in settings/* merge into settings.json on commit via Husky + lint-staged, and after any pull, merge,
or rebase that changes settings/ (Husky post-merge and post-rewrite).

Edit only settings//*.jsonc (never settings.json directly). Merging happens automatically, or run
just merge-settings manually.

Run just settings-drift to compare settings.json with the sources. The recipe merges settings/ in a temporary
directory and prints a diff grouped by top-level key. Lines marked - exist only in settings.json. Lines marked +
exist only in the sources. It exits 1 on drift and 0 when clean. Run just settings-drift --self-test to test the
recipe against fixtures.

When drift shows a change made outside the sources, port the change into the owning settings/*.jsonc file. Then rerun
just settings-drift. Do this before just merge-settings, because the merge overwrites settings.json.

Settings layout:

- basics.jsonc: core config, env vars, status line
- hooks.jsonc: event hooks
- plugins.jsonc: enabled plugins
- permissions/*.jsonc: permission rules (additional-dirs, bash, read)

Context

CLAUDE.md is user-level context loaded by Claude Code across all projects. It is generated from
PaulRBerg/dot-agents's AGENTS.md — the canonical source — via that repo's
Husky + lint-staged pre-commit hook; do not hand-edit it here. Keep repo-specific guidance in project…