Dotfiles Claude Code + Codex
jckeen/dotfiles
Setup opcionado one-command para Claude Code/Codex com orquestra de agentes
Ver no GitHubConfiguração one-command que transforma uma máquina vazia em um ambiente completo de Claude Code e Codex com padrões sensatos, hooks de segurança, orquestração de 17 agentes de revisão e multi-sessão. Suporta macOS, Windows (WSL2) e Linux com automação de higiene, status line ao vivo e 15 slash commands para todo o ciclo de desenvolvimento.
Instalação
npx convez-ai jckeen/dotfiles1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Jumpstart de ambiente de desenvolvimento com Claude/Codex em novo machine
- Automação de fluxos de revisão de código com múltiplos agentes especializados
- Gerenciamento de múltiplas sessões simultâneas de Claude em diferentes projetos
- Enforcement de boas práticas (commits convencionais, formatação, segurança)
Veredito

Dotfiles robusto e opinado para quem quer Claude Code/Codex com setup zero-friction e governança forte. Excelente para teams ou power users que repetidamente fazem setup de máquinas; exige conforto com shell scripting e arquitetura de agentes para aproveitar ao máximo.
README
A tradução para o português deste README ainda está na fila.
Dotfiles — A Jumpstart for Claude Code + Codex
A one-command setup that gets you from a blank machine to a full Claude Code + Codex working environment with sane defaults, safety hooks, multi-session tooling, and a 17-agent code-review orchestra. Built for macOS and Windows (via WSL2 + Ubuntu), with Linux supported as a side effect.
This is opinionated — it's how I (and now hopefully you) run Claude Code and Codex day-to-day. Clone it, run ./setup.sh, and skip months of trial-and-error.
Get started:
git clone https://github.com/jckeen/dotfiles.git && cd dotfiles && ./setup.sh
Best practices sourced from Boris Cherny (creator of Claude Code), the official Claude Code docs, and hard-won experience across thousands of agent sessions.
What you get (and why it matters)
After setup, you don't have to remember much. Open a terminal and:
cc— one alias that pulls every repo in your~/dev/directory (fast-forward only), syncs your memory repo, runs a health check, then launches Claude Code.cxdoes the same for Codex. No more "is my repo up to date?" or "did I forget to pull?" — that's automatic now.- A live status line — model name, context-bar (green/yellow/red), git branch, lines added/removed, session cost in USD. You always know how warm your context is, what branch you're on, and what the session has cost — without asking.
- 15 slash commands that cover the whole loop —
/kickoff(new project),/review(quality + security),/simplify(de-engineer),/fix-issue(GitHub issue end-to-end),/handoff(clean session transition),/changelog,/log-error,/commit-push-pr,/claude-server,/decompose,/max,/branch-hygiene,/jj(jujutsu driver),/session-retro(improve your own skills),/drift-sweep(doc-contract bootstrap + drift audit). Type the verb, get the workflow. - A 17-agent review orchestra —
qa-lead,security-reviewer,frontend-architect,backend-architect,ux-reviewer,growth-strategist,trust-safety,perf-accessibility, and 9 more. Each runs in its own isolated context and reports back without polluting your main session. Three-phase orchestration (Product → Architecture → Launch) for serious reviews. - Safety hooks that can't be forgotten — auto-format on edit (prettier, black, rustfmt, gofmt), conventional-commit enforcement, push notifications when Claude is waiting on you, and a
StripProjectPermissionshook that prevents per-project permission creep from overriding your global allowlist. - Multi-session tooling — open 3, 5, or 8 Claude sessions across different projects in a single Windows Terminal window via
cc-pane/cc-tab/cc-multi(bash) orccgrid/cctab/ccpane(PowerShell). Each session gets the fullcctreatment — repo sync, tab colors, health check. - Agent-neutral helpers —
wsl6opens a 3×2 grid of plain WSL shells (no Claude/Codex coupling) for ad-hoc multi-shell work. - Auto-hygiene — a daily systemd timer cleans stale branches across every repo in
~/dev/, surfaces drift at every Claude/Codex session start, and bootstraps the canonical 8 GitHub auto-merge settings on every newly-created or cloned repo. - Public-safe Codex parity — same skill set as Claude (review, simplify, fix-issue, commit-push-pr, handoff, changelog, repo-health, branch-hygiene), wired so
cxmirrorscc. Codex auth, sessions, sqlite state, and liveconfig.tomlstay local; only public-safe guidance and skills are shared. - Cross-platform symlink hygiene —
setup.shis idempotent and runs the same on macOS and WSL. Edit~/.claude/agents/foo.mdand the change is in your repo automatically (it's a symlink).dotfiles-updatekeeps everything in sync with one command.
Why this exists: Claude Code and Codex are powerful but the defaults aren't tuned for serious daily work — context bloats, sessions vanish without handoffs, branches pile up, agent reviews are ad-hoc, and you re-discover the same gotchas every project. This repo encodes the "second-day knowledge" that makes the tools actually compound. If you're going to spend hundreds of hours in these CLIs, spend the first 10 minutes setting up properly.
Quick Start
Pick your platform. Each path leaves you with the same end state: Claude Code + Codex installed, hooks wired, slash commands available, status line showing, multi-session helpers ready.
Claude Code runs much better in WSL2 than directly on Windows: native Linux filesystem (~10x faster I/O than /mnt/c/), full POSIX tooling, and our PowerShell helpers (wsl6, ccgrid, etc.) bridge nicely between Windows Terminal and WSL.
Prerequisites — install these once, in PowerShell as Administrator (skip any you already have):
# 1. WSL2 + Ubuntu (reboot if it's a fresh WSL install)
wsl --install -d Ubuntu
# 2. PowerShell 7 (preferred — Windows ships with PS 5.1, but PS 7 is faster
# and is what you should be using day-to-day)
winget install --id Microsoft.PowerShell --source winget
# 3. Windows Terminal (preinstalled on Windows 11; install on 10)
winget install --id Microsoft.WindowsTerminal --source winget
Why PowerShell 7? PS 5.1 is end-of-life maintenance only and uses
Documents\WindowsPowerShell\for its profile. PS 7 is the modern, cross-platform Core build, usesDocuments\PowerShell\, and is faster on every workload.setup.shwires our helpers into both profiles so you're covered either way, but you should default to PS 7.
Inside WSL (open Ubuntu from the Start menu, or wsl from any terminal):
# Clone this repo into the Linux filesystem (NOT /mnt/c/ — that's ~10x slower)
mkdir -p ~/dev && cd ~/dev
git clone https://github.com/jckeen/dotfiles.git
cd dotfiles
# Run setup — auto-detects WSL, installs everything, prompts where it matters
./setup.sh
# Authenticate (do these once)
gh auth login # GitHub CLI — choose HTTPS + browser
claude # Sign in to Claude (or 'claude auth login' if it doesn't prompt)
codex login # Optional: sign in for Codex CLI
You're done. Open a new PowerShell 7 window and try wsl6, or run cc inside WSL.
Prerequisites — install these once if you don't have them:
# 1. Xcode Command Line Tools (gives you git, clang, etc.)
xcode-select --install
# 2. Homebrew (everything else installs through this)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Then:
mkdir -p ~/dev && cd ~/dev
git clone https://github.com/jckeen/dotfiles.git
cd dotfiles
# Run setup — auto-detects macOS, installs Node/bun/gh/jq via brew if missing
./setup.sh
# Authenticate
gh auth login
claude
codex login # Optional
Why macOS? Native Unix toolchain, no VM overhead, excellent terminal options (Terminal.app, iTerm2, Ghostty, Warp — pick your favorite). The setup script handles macOS-specific things (osxkeychain credential helper, brew package install, zsh
.bash_aliasessourcing) automatically.
mkdir -p ~/dev && cd ~/dev
git clone https://github.com/jckeen/dotfiles.git
cd dotfiles
./setup.sh
gh auth login
claude
codex login # Optional
Setup-script flags (all platforms)
./setup.sh # default: install everything, prompting only where it matters
./setup.sh --check # read-only audit of all symlinks; exits non-zero if broken
./setup.sh --repair # audit + recreate any broken/missing symlinks
./setup.sh --dry-run # show what would change without writing anything
./setup.sh --help # usage and flag reference
Public repo safety: this dotfiles repo is public. Don't commit Codex/Claude auth tokens, generated sessions, sqlite state, logs, caches, private memory, account IDs, private MCP endpoints, personal identity notes, or client/project details. Private state lives in
claude-memoryandcodex-memory(separate private repos — see below). CI enforces this on every PR: a gitleakssecret-scanjob (token/key/credential shapes, full-history) and aleak-scanjob (machine-specific home paths) both have to pass before merge.
Private memory (optional): if you keep a private
claude-memoryrepo under~/dev/,setup.shcalls itsbootstrap.shto symlink your Claude Codesettings.json(MCP servers, permissions, plugins) into~/.claude/. Without it you still get hooks, skills, agents, status line, and dotfiles — the globalclaude/CLAUDE.mdis symlinked either way.
WSL filesystem rule: Always clone repos under
~/dev(Linux filesystem), not/mnt/c/(Windows mount). File I/O on the native Linux filesystem is ~10x faster. The setup script auto-configures your shell tocd ~/devon startup.
Try it now
After setup, run these to see what you've got:
cc # pulls all your repos, then launches Claude
cx # pulls all your repos, then launches Codex
dotfiles-update # pull latest dotfiles + re-run setup (idempotent — safe anytime)
projects # list everything under ~/dev/
sessions # show active Claude sessions and their cwds
Once inside Claude:
- Type
/reviewto run a code quality check on your last few commits - Type
/simplifyafter writing code to remove unnecessary complexity - Ask "Run the qa-lead agent on this project" to spawn an isolated review
- Watch the status line — it shows context %, git branch, cost, and lines changed
Windows (PowerShell 7) users — open a fresh PowerShell 7 window and try:
| Command | What it does |
|---|---|
wsl6 | Opens a Windows Terminal tab with a 3×2 grid of plain WSL shells (agent-neutral) |
ccprojects | Lists projects available under your WSL ~/dev/ |
ccgrid dotfiles atlas stringer | One new tab, three split panes, each running cc <project> inside WSL |
cctab dotfiles atlas | One tab per project, each running cc <project> inside WSL |
ccpane dotfiles | Splits the current Windows Terminal window with cc dotfiles |
These are auto-installed by setup.sh on WSL (it asks "Install into your PowerShell profile(s)? [Y/n]" — answer Y). The installer wires both PS 5.1 and PS 7 profiles, so the helpers work in whichever you prefer. If you missed the prompt or installed before this fix, just run dotfiles-update from WSL. Manual install, distro/dev-dir overrides, and more: docs/WINDOWS.md.
What this installs and configures
setup.sh installs CLI tools, symlinks Claude/Codex config into ~/.claude/ and ~/.codex/, and wires platform-specific bits (audio on WSL, credential helpers per OS, etc.). Expand below for the full inventory.
| Tool | Purpose | Install method |
|---|---|---|
gh | GitHub CLI | Homebrew (macOS) / apt (Linux) |
git | Version control | Homebrew / apt |
node | Node.js LTS | Homebrew / NodeSource |
jq | JSON processing (used by hooks) | Homebrew / apt |
claude | Claude Code CLI | npm |
codex | OpenAI Codex CLI | npm |
bun | Runtime for *.hook.ts hooks | Homebrew / npm |
WSL also gets: pulseaudio-utils, libasound2-plugins, alsa-utils (for audio routing).
Public Claude config pieces are symlinked from this repo to ~/.claude/, so edits in either location stay in sync. The global instructions live in this repo and are symlinked into ~/.claude/; private settings (MCP servers, permissions, plugins) come from claude-memory. Codex is stricter: only public-safe guidance and skills are symlinked into ~/.codex/; live ~/.codex/config.toml stays local because Codex stores machine-specific project trust there.
| What | Files | Purpose |
|---|---|---|
| Claude instructions | claude/CLAUDE.md | Global rules Claude follows in every session (symlinked into ~/.claude/CLAUDE.md) |
| Settings | ~/dev/claude-memory/settings.json | Private permissions, MCP servers, plugins (symlinked into ~/.claude/ by claude-memory's bootstrap.sh) |
| Agent Pack | AgentPack.md | 17-agent review orchestra (loaded on-demand, not symlinked) |
| Status line | statusline.sh | Shows model, context %, git branch, lines changed, session cost |
| Commit hook | hooks/conventional-commit.sh | Enforces type: description commit message format |
| Format hook | hooks/format-on-edit.sh | Auto-formats files after edits (prettier, black, rustfmt, gofmt) |
| Notification hook | hooks/ntfy-awaiting-input.sh | Sends push notification when Claude needs input |
| Permission guard | hooks/StripProjectPermissions.hook.ts | Strips project-level permission overrides on SessionStart |
| Skills | skills/*/SKILL.md | Claude slash commands (see below) |
| Subagents | agents/*.md | 17 specialized review agents |
| Shell aliases | .bash_aliases | cc, pull-all, worktree shortcuts |
| Codex guidance | codex/AGENTS.md | Public-safe global Codex working rules |
| Codex skills | codex/skills/*/SKILL.md | Public-safe Codex workflows for review, issue fixes, PRs, handoffs |
| Codex config example | codex/config.toml.example | Template only; live ~/.codex/config.toml stays local |
| Git config | .gitconfig + .gitconfig.local | Identity, editor, credential helper (per-platform) |
| Audio | .asoundrc (WSL only) | ALSA → PulseAudio routing |
| Feature | macOS | WSL | Linux |
|---|---|---|---|
| Package manager | Homebrew | apt | apt |
| Shell config | .zshrc | .bashrc | .bashrc |
| Credential helper | osxkeychain | Git Credential Manager (Windows) | git-credential-store |
| Audio | Built-in | ALSA → PulseAudio | N/A |
| Git safe.directory | Not needed | Auto-configured for /mnt/c/ | Not needed |
Daily use
The day-to-day reference is CLAUDE-GUIDE.md — the cheat sheet for slash commands, hooks (with their wired-state), keyboard shortcuts, shell commands, worktree/multi-session helpers, autonomous scripts, stop-hook templates, and the golden rules. What follows is the short version.
The commands you'll actually type
| Command | What it does |
|---|---|
cc [project] | Sync repos + memory, health check, launch Claude |
cx [project] | Same ergonomics for Codex |
cc-multi <p1> <p2> … | Multiple projects, one Windows Terminal tab each, fully synced |
dotfiles-update | Pull latest dotfiles + re-run setup (idempotent — safe anytime) |
/handoff | Capture session state before /clear or stopping |
/max | Maximum-effort mode — worktrees, parallel agents |
/fix-issue N | GitHub issue end-to-end: investigate → test → fix → PR |
Most other slash commands auto-invoke when their triggers match — you rarely type them. Full table: CLAUDE-GUIDE.
The loop
Plan → Build → Verify → Simplify → Review → Log → Handoff
Each step is a mode or slash command — see CLAUDE-GUIDE → The Workflow, including the push-time Codex review gate that blocks on critical findings.
Going wider
- Worktrees & multi-session —
za–ze/z0jump between worktrees,wt-claude <name>spawns Claude in a fresh one,cc-pane/cc-tab/cc-multifan out across Windows Terminal (from inside Claude:! cc-pane <project>). Tables in CLAUDE-GUIDE; the PowerShell side (wsl6,ccgrid,cctab,ccpane, manual install, distro overrides) lives in docs/WINDOWS.md. - The 17-agent review orchestra — spawn by name ("Use the qa-lead agent on
this feature"), in groups, or as a three-phase full review (Product →
Architecture → Launch).
/reviewand/simplifyuse them automatically. Roster and orchestration:claude/AgentPack.md. - Safety hooks — run automatically, can't be forgotten like CLAUDE.md
rules: conventional-commit enforcement, project-gated format-on-edit,
session-start symlink repair, permission-creep stripping, plugin drift
detection. The canonical wired-state table is in
CLAUDE-GUIDE → Hooks; files in
claude/hooks/. - Status line — model, context bar (green/yellow/red), branch, lines
changed, session cost. If the bar runs red:
/handoff, then/clear.
The private memory repos
This public dotfiles repo pairs with up to two separate private repos — claude-memory and (optional) codex-memory — that hold things that don't belong in public: Claude Code settings, auto-memory, archived personal context, and Codex preferences. Both are optional; without them you still get hooks, skills, agents, status line, git config, and cc/cx scaffolding.
claude-memory holds:
- Your Claude Code settings (
settings.json) — private permissions, MCP servers, and enabled plugins. - Your persistent Claude memory (
dev/memory/) — auto-memory files (MEMORY.md+feedback_*.md) Claude Code writes to~/.claude/projects/. Without this repo they only exist locally and vanish on machine rebuild. - Archived personal context (
pai-user/) — identity and steering notes kept for reference. These are no longer live-linked into Claude; they're retained as an archive. - Project notes (
stringer/,trnn/) — durable per-project context. - Your personal identity & preferences (
CLAUDE.md) — imported by the publicclaude/CLAUDE.mdvia@~/dev/claude-memory/CLAUDE.md, so identity loads globally while staying out of the public repo. - The
bootstrap.shscript that symlinkssettings.jsoninto~/.claude/.
Minimum structure:
~/dev/claude-memory/
├── bootstrap.sh # idempotent; runs at end of setup.sh — links settings.json
├── settings.json # symlinked into ~/.claude/settings.json
├── CLAUDE.md # personal identity, imported by public claude/CLAUDE.md
├── dev/
│ └── memory/ # Claude auto-memory (MEMORY.md + feedback_*.md)
├── pai-user/ # ARCHIVED personal identity/steering notes (not live-linked)
├── stringer/ # project notes
└── trnn/ # project notes
bootstrap.sh symlinks settings.json into ~/.claude/ (no voice server, no .env checks). setup.sh calls it automatically when the repo is present.
Creating your own — deliberately hand-crafted, no generator:
# Create the skeleton
mkdir -p ~/dev/claude-memory/dev/memory
cd ~/dev/claude-memory
# Your Claude Code settings (permissions, MCP servers, plugins)
touch settings.json
# A minimal bootstrap.sh that symlinks settings.json into ~/.claude/
# (idempotent; re-run safe)
# Publish it private
git init && git add -A && git commit -m "init: claude memory"
gh repo create claude-memory --private --source=. --push
check-claude.sh verifies the memory symlink is healthy alongside everything else.
This public dotfiles repo only tracks reusable Codex guidance, skills, and examples. Anything personal or generated belongs in an optional private repo at ~/dev/codex-memory for portable Codex memory and private instructions. Keep this separate from claude-memory; the tools have different runtime state and different config formats.
Minimum structure:
~/dev/codex-memory/
├── AGENTS.local.md # private Codex preferences
├── MEMORY.md # durable private notes
├── README.md
└── .gitignore
Never commit these from ~/.codex/:
auth.jsonhistory.jsonllogs_*.sqlite*orstate_*.sqlite*log/,sessions/,shell_snapshots/,cache/,.tmp/,tmp/- live
config.tomlproject trust entries - private MCP endpoints, token env values, account IDs, client names, or private project details
setup.sh links public codex/AGENTS.md and codex/skills/*/SKILL.md into ~/.codex/. It also links AGENTS.local.md and MEMORY.md into ~/.codex/ when the private repo exists. It does not migrate live ~/.codex state. check-codex.sh warns when private/generated Codex files exist so you remember they are local-only.
Customizing (forking this repo)
This repo is designed to be forked and adapted. Here's what to edit vs. leave alone:
Edit these only with public-safe content:
claude/AgentPack.md— add, remove, or modify review agentscodex/AGENTS.md— reusable Codex working rulescodex/skills/*/SKILL.md— reusable Codex workflowscodex/config.toml.example— example Codex config only.bash_aliases— your shell shortcuts
Keep private:
~/dev/claude-memory— personal Claude memory, settings, and archived context~/dev/claude-memory/settings.json— private Claude permissions, MCP servers, and plugins~/dev/codex-memory— personal Codex memory and private instructions- live
~/.codex/config.toml— machine-specific project trust and local settings
Leave these (the framework):
claude/hooks/*.shand*.ts— hooks (add new ones, but keep the defaults)claude/skills/*/SKILL.md— slash commands (add new ones as needed)claude/agents/*.md— subagent definitionssetup.sh— cross-platform installerclaude/statusline.sh— status line display
Architecture decisions
The why behind structural changes lives in docs/adr/ as
Architecture Decision Records, and the current backlog lives in
ROADMAP.md + GitHub Issues. This repo uses a four-layer record
model — Issues track what's next, CI-gated PRs are the unit of change, ADRs
capture the reasoning, and the CHANGELOG records what shipped.
ADRs are numbered NNNN-kebab-title.md and append-only: a decision that no
longer holds is superseded by a new record rather than edited away. Start with
ADR-0001, or copy
0000-template.md to write a new one.
Repo Structure
dotfiles/
├── setup.sh # Cross-platform bootstrap script
├── check-claude.sh # Health check — verifies symlinks/memory, detects orphans; --heal self-links missing (cc uses it)
├── check-codex.sh # Health check — verifies public-safe Codex symlinks
├── gh-bootstrap.sh # Bootstrap GitHub auto-merge settings on new repos
├── git-hygiene.sh # Stale-branch cleanup across repos in ~/dev/
├── hygiene-status.sh # Surface hygiene drift at session start
├── .bash_aliases # Shell aliases, functions, worktree shortcuts
├── .bash_profile # Login-shell bootstrap (sources .bashrc for wsl6/ssh)
├── .gitconfig # Base git config (includes .gitconfig.local)
├── .gitignore # Ignores generated files
├── .gitattributes # Line ending normalization (LF for scripts)
├── .asoundrc # WSL audio routing
├── LICENSE # MIT
├── README.md # This file
├── CLAUDE-GUIDE.md # Quick reference cheat sheet
├── CHANGELOG.md # Change log
├── ROADMAP.md # Backlog (paired with GitHub Issues)
├── docs/
│ ├── adr/ # Architecture Decision Records (numbered, append-only)
│ ├── WINDOWS.md # PowerShell helpers deep-dive (wsl6/ccgrid, manual install)
│ └── BRANCH_PROTECTION.md # Branch protection setup notes
├── codex/
│ ├── AGENTS.md # Public-safe Codex global guidance
│ ├── config.toml.example # Public-safe Codex config example
│ └── skills/ # Public-safe Codex workflows
│ ├── branch-hygiene/
│ ├── review/
│ ├── simplify/
│ ├── fix-issue/
│ ├── commit-push-pr/
│ ├── handoff/
│ ├── changelog/
│ └── repo-health/
├── claude/
│ ├── CLAUDE.md # Global Claude instructions (symlinked to ~/.claude/CLAUDE.md)
│ ├── AgentPack.md # 17-agent review orchestra
│ ├── plugins.txt # Plugin manifest (cross-machine source of truth)
│ ├── nolink.txt # Manifest of claude/ files deliberately NOT symlinked
│ ├── statusline.sh # Context bar, git branch, cost display
│ ├── chrome/ # WSL → Windows Chrome bridge for claude --chrome
│ ├── hooks/
│ │ ├── conventional-commit.sh # PreToolUse commit message validator
│ │ ├── format-on-edit.sh # PostToolUse auto-formatter
│ │ ├── ntfy-awaiting-input.sh # PreToolUse push notification
│ │ ├── StripProjectPermissions.hook.ts # SessionStart permission guard
│ │ ├── HygieneStatus.hook.sh # SessionStart hygiene drift surface
│ │ ├── PrePushStaleSHACheck.hook.ts # Warn on stale SHA before push
│ │ ├── PluginDriftCheck.hook.ts # SessionStart plugin drift detection
│ │ ├── SymlinkRepair.hook.ts # SessionStart symlink health and auto-repair
│ │ └── HandoffReminder.hook.sh # SessionStart: surface a recent handoff note
│ ├── skills/
│ │ ├── branch-hygiene/ # /branch-hygiene — stale branch cleanup
│ │ ├── kickoff/ # /kickoff — new project bootstrap
│ │ ├── changelog/ # /changelog — session logging
│ │ ├── log-error/ # /log-error — error documentation
│ │ ├── review/ # /review — code quality check
│ │ ├── handoff/ # /handoff — session transitions
│ │ ├── fix-issue/ # /fix-issue — GitHub issue workflow
│ │ ├── simplify/ # /simplify — complexity removal
│ │ ├── commit-push-pr/ # /commit-push-pr — one-shot shipping
│ │ ├── claude-server/ # /claude-server — remote worktree
│ │ ├── decompose/ # /decompose — deep task decomposition
│ │ ├── max/ # /max — maximum effort parallel execution
│ │ ├── jj/ # /jj — jujutsu (jj) version control driver
│ │ └── session-retro/ # /session-retro — propose improvements to your skills
│ ├── handoffs/ # Session handoff notes (gitignored — ephemeral)
│ ├── scripts/ # Headless automation + validation scripts
│ │ ├── common.sh # Shared safety tiers + runner
│ │ ├── health-check.sh # Read-only repo health audit
│ │ ├── hygiene-cron.sh # Daily cron wrapper for git-hygiene across all repos
│ │ ├── full-review.sh # 3-phase agent pack review
│ │ ├── test-coverage.sh # Write tests for uncovered code
│ │ ├── fix-issues.sh # Auto-pick and fix GitHub issues
│ │ ├── overnight.sh # Orchestrate all scripts across repos
│ │ ├── review-and-push.sh # Morning review of overnight changes
│ │ ├── sync-plugins.sh # Sync installed plugins against plugins.txt
│ │ ├── codex-review-gate.sh # Local Codex review gate used by commit-push-pr
│ │ ├── check-hooks-wired.sh # Warn when a hook file isn't registered in settings.json
│ │ ├── check-doc-refs.sh # CI: validate doc path references and links
│ │ ├── check-agent-parity.sh # CI: keep CLAUDE.md and codex/AGENTS.md rules in sync
│ │ ├── check-commit-format.sh # CI: conventional-commit enforcement on PRs
│ │ ├── check-no-personal-data.sh # CI: block machine-specific home paths
│ │ └── check-skill-parity.sh # CI: skill count + Claude/Codex artifact shapes
│ ├── systemd/ # systemd units (git-hygiene timer)
│ └── agents/ # 17 specialized review subagents
├── product-strategist.md
├── ux-reviewer.md
├── frontend-architect.md
├── backend-architect.md
├── growth-strategist.md
├── content-reviewer.md
├── trust-safety.md
├── qa-lead.md
├── perf-accessibility.md
├── launch-operator.md
├── security-reviewer.md
├── code-simplifier.md
├── repo-scout.md
├── dependency-doctor.md
├── package-scout.md
├── test-writer.md
└── schema-reviewer.md
└── windows/
├── wsl-helpers.ps1 # Agent-neutral PowerShell helpers (wsl6 — 3×2 WSL grid)
└── cc-functions.ps1 # Claude-specific launchers (ccgrid/cctab/ccpane/ccprojects/ccupdate)
Sources
- How Boris Uses Claude Code — Tips from the creator
- Official Best Practices — Anthropic's documentation
- Claude Code Hooks Guide — Hook documentation
- Trail of Bits Config — Security-focused config reference
Want to understand the reasoning behind these choices? Read the CHANGELOG.