dotfiles

My development environment configuration. Clone once, symlink everywhere.

Install

git clone git@github.com:KyleNesium/dotfiles.git ~/.dotfiles
cd ~/.dotfiles
./install.sh

The install script symlinks config files into their expected locations (~/.claude/). Existing files are backed up as .bak before overwriting. Safe to run multiple times.

On a new machine

# 1. Install prerequisites
brew install gh node

# 2. Clone and install
git clone git@github.com:KyleNesium/dotfiles.git ~/.dotfiles
cd ~/.dotfiles
./install.sh

What's included

Claude Code (claude/)

Global configuration for Claude Code.

File	Purpose
CLAUDE.md	Global instructions — git workflow, testing, code quality, security
settings.json	Auto-approved commands, accept-edits mode, extended thinking, plugins

Agents (claude/agents/)

Agent	Model	Purpose
swift-simplifier.md	Opus	Reduce nesting, simplify closures, enforce Swift naming conventions
swift-debugger.md	Sonnet	Fast-iteration debugging — crash logs, SwiftUI, concurrency
task-planner.md	Opus	Break complex tasks into phased implementation plans

Skills (claude/skills/)

Skill	Purpose
fix-github-issue	Read issue → branch → implement fix with tests → draft PR
review-pr	Structured PR review — code quality, security, tests, conventions
security-check	Scan for secrets, credentials, PII, and sensitive files before opening a PR
setup-github-repo	Configure repo for open-source release (CI, templates, settings)
write-readme	Generate a polished README from the codebase
peon-ping-toggle	Toggle peon-ping sound notifications on/off

Hooks (claude/hooks/)

Hook	Purpose
peon-ping	Warcraft-style sound notifications when Claude finishes a task

Structure

dotfiles/
├── claude/
│   ├── CLAUDE.md
│   ├── settings.json
│   ├── agents/
│   │   ├── swift-simplifier.md
│   │   ├── swift-debugger.md
│   │   └── task-planner.md
│   ├── skills/
│   │   ├── fix-github-issue/
│   │   ├── review-pr/
│   │   ├── security-check/
│   │   ├── setup-github-repo/
│   │   ├── write-readme/
│   │   └── peon-ping-toggle/
│   └── hooks/
│       └── peon-ping/
├── install.sh
└── README.md

Updating

Edit files in this repo, then run install.sh again (or just edit in place — symlinks mean changes are live immediately).

To pull updates on another machine:

cd ~/.dotfiles
git pull

No need to re-run install.sh unless new files were added — existing symlinks already point to the repo.