dotfiles

Personal dotfiles for macOS development environment setup.

Quick Start

Bootstrap (First Time Setup)

For a brand new Mac without Git installed, use the bootstrap script:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/gentamura/dotfiles/main/bootstrap.sh)"

This script will:

1. Check and install Command Line Tools (includes Git)
2. Clone this repository to ~/dotfiles
3. Run the full installation process

Manual Installation

If you already have Git installed:

# Clone the repository
git clone https://github.com/gentamura/dotfiles.git ~/dotfiles
cd ~/dotfiles

# Run the full installation
.bin/install.sh init

Installation Components

Full Installation

.bin/install.sh init

This runs all installation steps:

1. Command Line Tools check/installation
2. Homebrew installation and package setup
3. Dotfiles symlinking

Individual Components

You can run individual installation steps:

Command Line Tools

.bin/install.sh init
# or directly
.bin/install_init.sh

Checks if Command Line Tools are installed and installs them if needed.

Homebrew & Packages

.bin/install.sh brew
# or directly
.bin/install_brew.sh

Installs Homebrew (if needed) and all packages defined in Brewfile, including:

• Development tools (git, gh, neovim, tmux, etc.)
• Programming languages (rust, openjdk, etc.)
• Databases (postgresql, mysql, mongodb)
• Applications (Docker Desktop, iTerm2, VS Code, etc.)
• Security tools (git-secrets)

Dotfiles Linking

.bin/install.sh link
# or directly
.bin/install_link.sh

Creates symbolic links from this repository to your home directory. Existing files are backed up to ~/.dotbackup.

For machine-local/private shell variables, use .zshrc.local:

• Keep the real file at ~/dotfiles/.zshrc.local (not tracked by Git)
• Symlink ~/.zshrc.local to that file
• .zshrc loads ~/.zshrc.local automatically if present

Example:

cat > ~/dotfiles/.zshrc.local <<'EOF'
# 00-env
export OBSIDIAN_VAULT="$HOME/Documents/Obsidian Vault"
EOF
ln -snf ~/dotfiles/.zshrc.local ~/.zshrc.local

What's Included

Configuration Files

• .gitconfig - Git configuration
• .config/zed/ - Zed editor settings
• .config/mise/ - Mise tool configuration
• .stylua.toml - Lua formatting configuration

AI Agent Configuration

This repository supports both Codex and Claude workflows:

Component	Purpose	Location
Agent entrypoint	Shared agent operating index	AGENTS.md
Shared skills	Reusable procedures for both Codex and Claude	skills/
Claude rules	Always-on coding constraints	.claude/rules/
Claude agents	Role-based delegation profiles	.claude/agents/
Claude commands	Slash-command workflow templates	.claude/commands/

Notes:

• install_link.sh links ~/.claude/skills to repo skills/.
• install_link.sh keeps ~/.codex/skills/.system and links each shared skill directory from repo skills/ into ~/.codex/skills/.
• install_link.sh symlinks Claude config items (CLAUDE.md, README.md, rules/, agents/, commands/) into ~/.claude/ without replacing the whole ~/.claude runtime directory.

See .claude/CLAUDE.md, AGENTS.md and .claude/README.md for details.

Development Tools

See Brewfile for the complete list of installed tools and applications.

Requirements

• macOS
• Internet connection

Troubleshooting

Command Line Tools Installation

If the Command Line Tools installation dialog doesn't appear or fails:

1. Try installing manually:

   xcode-select --install
   

2. If already installed, verify:

   xcode-select -p
   

Homebrew Issues

If Homebrew installation fails:

1. Check the official installation guide: https://brew.sh
2. Ensure you have sufficient permissions
3. Try installing manually and then run .bin/install_brew.sh

Structure

dotfiles/
├── bootstrap.sh          # Bootstrap script for first-time setup
├── .bin/                 # Installation scripts
│   ├── install.sh        # Main installation script
│   ├── install_init.sh   # Command Line Tools installation
│   ├── install_brew.sh   # Homebrew and packages installation
│   └── install_link.sh   # Dotfiles symlinking
├── Brewfile              # Homebrew packages definition
├── AGENTS.md             # Shared agent entrypoint for local AI coding agents
├── skills/               # Shared skills (used by Codex and Claude)
├── .claude/              # Claude-specific configuration
│   ├── CLAUDE.md         # Operating model for Claude
│   ├── README.md         # Human documentation
│   ├── rules/            # Coding standards
│   ├── agents/           # Role-based agents
│   ├── commands/         # Slash commands
├── .config/              # Application configurations
├── .gitconfig            # Git configuration
└── README.md             # This file

License

MIT