Dotfiles

Personal dotfiles managed with chezmoi.

Quick Start

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

This handles everything automatically:

1. Installs Homebrew (if needed)
2. Installs chezmoi
3. Applies all dotfiles and runs setup scripts

Alternative (one-liner without cloning)

sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply tawanorg

What's Included

Shell Configuration

• .zshrc - Zsh configuration with aliases, functions, and prompt customization

Git Configuration

• .gitconfig - Git settings, aliases, and defaults

Claude Code Setup

• .claude/CLAUDE.md - Personal coding preferences for Claude
• .claude/rules/ - Workflow and coding style preferences

Application Configs

• .config/ - Application-specific configurations

Automatic Setup

Everything is installed automatically via ./install.sh or chezmoi apply:

Shell Dependencies (Homebrew)

Tool	Purpose
chezmoi	Dotfiles manager
go	For building custom tools
starship	Cross-shell prompt
zoxide	Smarter cd command
fzf	Fuzzy finder
zsh-autosuggestions	Fish-like suggestions
zsh-syntax-highlighting	Syntax highlighting for zsh

Custom Tools

Tool	Repository	Purpose
claude-sync	tawanorg/claude-sync	Sync Claude settings across machines

MCP Servers (Auto-installed)

These MCP servers require no secrets and are installed automatically:

Server	Package	Purpose
voltagent	@voltagent/docs-mcp	VoltAgent documentation
sequential-thinking	@modelcontextprotocol/server-sequential-thinking	Complex problem-solving, architectural design
memory	@modelcontextprotocol/server-memory	Persistent knowledge graph across sessions
puppeteer	@modelcontextprotocol/server-puppeteer	Browser automation, screenshots, scraping
playwright	@executeautomation/playwright-mcp-server	Browser testing, UI automation

Skills (Auto-installed)

Development pattern skills from various sources:

• Architecture patterns (Clean, Hexagonal, DDD)
• API design principles (REST, GraphQL)
• Authentication patterns (JWT, OAuth2, RBAC)
• Git advanced workflows
• GitHub Actions templates
• React Native architecture
• Prompt engineering patterns
• And more...

Manual Setup

MCP Servers Requiring Secrets

These MCP servers require API keys or authentication. Add them manually after obtaining credentials:

GitHub

Get a personal access token from https://github.com/settings/tokens

claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxx -- npx -y @modelcontextprotocol/server-github

Brave Search

Get an API key from https://brave.com/search/api/

claude mcp add brave-search -e BRAVE_API_KEY=xxx -- npx -y @anthropic/mcp-server-brave-search

Context7

claude mcp add context7 -- npx -y @upstash/context7-mcp

Sentry

Authenticates via browser:

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

Linear

Authenticates via browser:

claude mcp add linear -- npx -y mcp-remote https://mcp.linear.app/mcp

Supabase

claude mcp add supabase -- npx -y @supabase/mcp-server-supabase

Slack

claude mcp add slack -e SLACK_BOT_TOKEN=xxx -e SLACK_TEAM_ID=xxx -- npx -y @anthropic/mcp-server-slack

Verification

After setup, verify everything is installed:

# Check custom tools
claude-sync --version

# Check MCP servers
claude mcp list

Expected MCP servers:

- voltagent
- sequential-thinking
- memory
- puppeteer
- playwright

Common Commands

# Apply changes
chezmoi apply

# See what would change
chezmoi diff

# Edit a managed file
chezmoi edit ~/.zshrc

# Add a new file to chezmoi
chezmoi add ~/.some-config

# Update from remote
chezmoi update

# Re-run setup scripts (force reinstall everything)
chezmoi state delete-bucket --bucket=scriptState
chezmoi apply

# Update claude-sync to latest version
GOPROXY=direct go install github.com/tawanorg/claude-sync/cmd/claude-sync@latest

Directory Structure

dotfiles/
├── install.sh                          # Bootstrap script (run this first)
├── README.md                           # This file
├── dot_claude/                         # ~/.claude/
│   ├── CLAUDE.md                       # Claude Code preferences
│   └── rules/                          # Coding/workflow rules
├── dot_config/                         # ~/.config/
├── dot_gitconfig                       # ~/.gitconfig
├── dot_zshrc                           # ~/.zshrc
├── private_Library/                    # ~/Library/ (macOS)
└── run_once_after_10-install-skills.sh # Auto-setup script (runs via chezmoi)

Customization

Adding New MCP Servers

Edit run_once_after_10-install-skills.sh and add:

run_with_spinner "server-name" claude mcp add server-name -- npx -y @package/name

Modifying Claude Preferences

Edit the files in dot_claude/:

• CLAUDE.md - Main preferences
• rules/preferences.md - Coding style
• rules/workflows.md - Development workflow

Troubleshooting

Setup script didn't run

Force re-run of setup scripts:

chezmoi state delete-bucket --bucket=scriptState
chezmoi apply

Go package not updating to latest version

Go proxy caches packages. Use GOPROXY=direct to bypass:

GOPROXY=direct go install github.com/tawanorg/claude-sync/cmd/claude-sync@latest

MCP server not working

Check server status:

claude mcp list
claude mcp remove server-name
claude mcp add server-name -- npx -y @package/name

Merge conflicts

chezmoi merge ~/.conflicted-file