dev-setup-template

Development environment template with dotfiles + AI coding tools (Claude Code, OpenCode).

Features

• Shell: Zsh with Zinit plugin manager, Powerlevel10k theme
• Terminal: Ghostty (macOS) / WezTerm (Windows)
• Claude Code: Commands, skills, hooks, agents
• OpenCode: Commands, skills, agents
• Sync: Automatic Claude ↔ OpenCode settings sync

Quick Start

macOS

# Clone
git clone https://github.com/YOUR_USERNAME/dotfiles.git ~/.dotfiles

# Install
cd ~/.dotfiles
./install.sh

Windows (PowerShell as Admin)

# Clone
git clone https://github.com/YOUR_USERNAME/dotfiles.git $env:USERPROFILE\.dotfiles

# Install
cd $env:USERPROFILE\.dotfiles
.\install.ps1

Structure

.
├── .gitconfig.example     # Git config template
├── .zshrc.example         # Zsh config template
├── Brewfile               # Homebrew packages
├── install.sh             # macOS installer
├── install.ps1            # Windows installer
├── link.sh                # Symlink creator
├── sync-ai-tools.sh       # Claude ↔ OpenCode sync
│
├── claude/                # Claude Code settings
│   ├── CLAUDE.md          # Global instructions
│   ├── commands/          # Slash commands
│   ├── skills/            # Context skills
│   ├── hooks/             # Event hooks
│   └── agents/            # Custom agents
│
├── opencode/              # OpenCode settings
│   ├── AGENTS.md          # Agent definitions
│   ├── command/           # Commands
│   ├── skill/             # Skills
│   └── agent/             # Agents
│
├── config/
│   └── ghostty/config     # Ghostty terminal config
│
└── ssh/
    └── config.example     # SSH config template

Included Commands

Command	Description
/git	Unified git workflow
/code-explain	Explain selected code
/code-refactor	Refactor code
/code-test	Generate tests
/dot-push	Sync & push dotfiles
/dot-sync	Pull dotfiles
/push-all	Push all repos
/sync-all	Sync all repos
/weekly-review	Generate weekly review

Included Skills

Skill	Description
git-workflow	Git branching & commit guide
tech-writing	Technical documentation
project-init	Project scaffolding
docker	Docker container management
dotfiles-management	Dotfiles sync guide
claude-commands	Claude command creation
weekly-review	Weekly retrospective

Daily Usage

# Sync dotfiles
dotpush    # Sync AI tools + commit + push
dotsync    # Pull from remote

# Manual AI tools sync
~/.dotfiles/sync-ai-tools.sh

Setup Steps

1. Clone this repo as ~/.dotfiles
2. Copy .gitconfig.example → .gitconfig and edit
3. Copy .zshrc.example → .zshrc and customize
4. Copy ssh/config.example → ssh/config and add hosts
5. Run ./install.sh (macOS) or .\install.ps1 (Windows)
6. Restart terminal

Customization

Adding Claude Commands

Create claude/commands/your-command.md:

Your command prompt here...

Adding Skills

Create directory claude/skills/your-skill/:

your-skill/
├── index.md      # Main skill prompt
└── knowledge.md  # Optional context

Related Templates

• note-template - Obsidian PARA + Zettelkasten

License

MIT