cc-settings

Claude Code configuration for the Darkroom team — installs agents, skills, hooks, and coding standards into ~/.claude/.

Install

# macOS / Linux
bash <(curl -fsSL https://raw.githubusercontent.com/darkroomengineering/cc-settings/main/setup.sh)

# Windows (PowerShell)
.\setup.ps1

Requires Bun ≥ 1.1.30 — the bootstrap installs it automatically if missing. Re-installs are non-destructive: existing permissions, custom hooks, and local overrides survive.

Restart Claude Code after install.

What gets installed

~/.claude/
├── AGENTS.md           # Portable coding standards (read by all AI tools)
├── CLAUDE.md           # Claude-Code-specific config
├── settings.json       # Composed from config/*.json (permissions, hooks, MCP)
├── agents/             # 10 specialized subagents
├── skills/             # 26 auto-invocable skills
├── profiles/           # Stack contexts: nextjs, react-native, tauri, webgl, maestro
├── rules/              # Path-conditioned rules (load on-demand by file type)
├── contexts/           # Ecosystem contexts
└── src/                # Hook + script implementations (TypeScript)

Repo → install mapping:

Common commands

bash setup.sh                  # Install / update
bun src/setup.ts --rollback    # Restore the previous backup
bun src/setup.ts --dry-run     # Preview what would change
bun run compose                # Preview the composed settings.json
bun run lint:skills            # Validate skill frontmatter + cap (≤40)
bun run audit:hooks            # Classify hooks as trusted/unknown/suspicious
bun run typecheck              # TypeScript check
bun test                       # Run all tests

Docs

Why

Shared config means every engineer on the team runs the same agents, the same guardrails, and the same coding standards — no per-machine drift. AGENTS.md is the open standard for AI coding instructions and is also read by Codex, Cursor, Copilot, and Windsurf, so the rules follow you across tools.

darkroom.engineering · MIT