dotfiles

Personal Claude Code development environment configuration.

Quick Start

git clone https://github.com/MuchanKim/dotfiles.git ~/dotfiles
cd ~/dotfiles
./install.sh

The install script creates symlinks from ~/.claude/ to this repo. Existing files are backed up with .bak suffix.

After Install

Install Claude Code plugins manually (not managed by dotfiles):

claude plugin add github
claude plugin add superpowers
claude plugin add swift-lsp

For Apple projects, register the apple-docs MCP at project level:

claude mcp add apple-docs --project -- npx -y @kimsungwhee/apple-docs-mcp@latest

What's Included

claude/
├── CLAUDE.md                  → ~/.claude/CLAUDE.md (global agent rules)
├── settings.json              → ~/.claude/settings.json (runtime config)
├── mcp.json.template          → ~/.claude/.mcp.json (generated with $HOME substitution)
├── rules/                     → ~/.claude/rules/
│   ├── git-conventions.md         Commit, PR, issue, branch rules
│   ├── apple-platform.md         Apple dev rules (build, App Store, SwiftUI)
│   ├── swift-conventions.md      Swift naming conventions (opt-in per project)
│   ├── posting-style.md          Blog/article writing style guide
│   └── obsidian-conventions.md   Note types, frontmatter, knowledge graph
└── templates/                 → ~/.claude/templates/
    ├── apple-project.md          Project CLAUDE.md template for Apple apps
    └── init-apple-project.sh     Interactive setup script (platform, arch, distribution)

Usage in Projects

Apple project setup

Run the init script from the project root:

~/.claude/templates/init-apple-project.sh

Or Claude will suggest running it when it detects a new Apple project without a CLAUDE.md.

Reference global rules from a project CLAUDE.md

@~/.claude/rules/apple-platform.md
@~/.claude/rules/swift-conventions.md

Set commit language per project

In project's .claude/CLAUDE.md:

## Project Overrides
- Commit/PR/Issue language: Korean

Updating

Edit files in ~/dotfiles/ directly — symlinks make changes take effect immediately.

cd ~/dotfiles
git add -A && git commit -m "[Chore] #N - description"
git push

On other machines:

cd ~/dotfiles && git pull

Changelog

2026-04-13

• Translate all Korean content in rules to English: CLAUDE.md, git-conventions.md, apple-platform.md, posting-style.md
• git-conventions.md: Ask commit language on first commit if not specified in project CLAUDE.md; add PR label requirement
• posting-style.md added to rules directory listing below

2026-04-08

• Rewrite git-conventions.md: new [Type] #issue format, flexible commit language (Korean/English per project), AI trace forbidden
• Add swift-conventions.md: Swift naming conventions as opt-in per-project rules
• Slim down apple-platform.md: remove architecture/project structure (moved to templates), keep platform-common rules only
• Add templates/: Apple project CLAUDE.md template + interactive init script
• Add mcp.json.template: Obsidian MCP with iCloud path support
• Update CLAUDE.md: commit now requires user approval, Apple project init script reference added
• Update install.sh: support templates and MCP config generation

2026-03-28

• Initial dotfiles setup: CLAUDE.md, settings.json, rules/ (apple-platform, git-conventions, obsidian-conventions)