Modern dotfiles configuration for macOS development environment.

• One-line setup: Fully automated installation with a single command
• Modern stack: mise (version manager), sheldon (plugin manager), lazygit (Git TUI)
• Declarative: Brewfile for package management
• Customizable: Pure prompt with version display in project directories
• macOS defaults: Automatically configures keyboard, trackpad, dock, and display settings

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

The script will automatically:

• Clone the dotfiles repository to ~/.dotfiles (requires git/Xcode Command Line Tools)
• Install all dependencies via Homebrew
• Create symlinks for configuration files
• Set up shell environment

Note: You may be prompted for your sudo password when setting the default shell. The script does not require running with sudo - it will request elevated privileges only when needed.

# 1. Clone repository
git clone https://github.com/tokichie/dotfiles.git ~/.dotfiles

# 2. Run bootstrap script
cd ~/.dotfiles
./bootstrap.sh

# 3. Restart terminal
exec zsh

• Core: zsh, git, gh, ghq, fzf, jq, yq, tree, direnv, neovim, tmux, zoxide
• Version Managers: mise (replaces rbenv/goenv/pyenv/n)
• Git: lazygit, jj (Jujutsu), git-delta
• Media: ffmpeg, imagemagick
• Cloud/Infra: terraform, tflint, azure-cli, cloudflared, supabase, gcloud, kubectl, cue
• Database: pgcli, libpq
• Protocol/API: buf, grpcurl

• claude-code: Installed via curl -fsSL https://claude.ai/install.sh | bash
• codex: Installed via npm i -g @openai/codex

• Development: Visual Studio Code, Cursor, Ghostty
• Productivity: Raycast, Obsidian, Notion, Todoist
• Security: Bitwarden
• Database: DBeaver Community
• AI: ChatGPT
• Input Method: Google Japanese IME
• Containers: OrbStack
• Utilities: Karabiner Elements

• Display: Maximum scaled resolution
• Keyboard: Fastest key repeat, function keys as standard F1-F12
• Keyboard Shortcuts: Spotlight disabled, Desktop switching (Ctrl+1-5), unused Mission Control shortcuts disabled
• Virtual Desktops: Automatically creates 5 desktops via Mission Control
• Trackpad: Traditional scroll direction, tracking speed 3, tap to click enabled
• Dock: 45px tile size
• Screenshots: Saved to ~/Pictures/ScreenShots/

• Modifier Keys: Caps Lock → Control (see Post-Installation section)

# Check mise
mise doctor
mise list

# Check sheldon
sheldon list

# Check installed versions
node -v
go version
python --version
ruby -v

# Launch lazygit
lazygit

Navigate to a project directory with .mise.toml or go.mod:

cd ~/ghq/github.com/example/project
# Node/Go versions should appear in left prompt

Set up Caps Lock → Control in System Settings:

# 1. Open System Settings
# 2. Go to Keyboard → Keyboard Shortcuts → Modifier Keys
# 3. Select your keyboard from the dropdown
# 4. Change "Caps Lock" to "Control"
# 5. Click "Done"

Raycast settings can be imported manually:

# 1. Open Raycast Settings (Cmd+,)
# 2. Go to Advanced tab
# 3. Click "Import Configuration"
# 4. Select ~/.dotfiles/raycast/raycast.rayconfig
# 5. Enter password to import

See raycast/README.md for details.

After confirming mise is working correctly, you can remove old version managers:

# Optional: Remove legacy directories
rm -rf ~/.rbenv ~/.goenv ~/.pyenv ~/.n

~/.dotfiles/
├── bootstrap.sh              # Setup script
├── Brewfile                  # Homebrew dependencies
├── _zshrc                    # Zsh configuration
├── _gitconfig                # Git configuration
├── raycast/
│   ├── README.md             # Raycast import instructions
│   └── raycast.rayconfig     # Raycast settings (password-protected)
└── config/
    ├── ghostty/
    │   └── config            # Ghostty terminal settings
    ├── karabiner/
    │   └── karabiner.json    # Keyboard remapping
    ├── sheldon/
    │   └── plugins.toml      # Zsh plugins
    ├── lazygit/
    │   └── config.yml        # Lazygit settings
    └── mise/
        └── config.toml       # Version management

Edit Brewfile and add:

brew "package-name"
cask "app-name"

Then run:

brew bundle --file=~/.dotfiles/Brewfile

Edit ~/.config/mise/config.toml:

[tools]
node = "20.0.0"  # Specify exact version
python = "latest"

Then run:

mise install

Edit _zshrc to modify the pure_prompt_version_info() function.

Edit LaunchAgents/com.user.keyremapping.plist to change key mappings. After editing:

# Reload the LaunchAgent
launchctl unload ~/Library/LaunchAgents/com.user.keyremapping.plist
launchctl load ~/Library/LaunchAgents/com.user.keyremapping.plist

# Verify current mappings
hidutil property --get "UserKeyMapping"

Common key codes for hidutil:

• Caps Lock: 0x700000039
• Left Control: 0x7000000E0
• Right Control: 0x7000000E4
• Escape: 0x700000029
• Left Command: 0x7000000E3
• Right Command: 0x7000000E7

brew update && brew upgrade

sheldon lock --update

mise upgrade

# Reinstall plugins
sheldon lock --update
source ~/.zshrc

# Ensure mise is activated
echo 'eval "$(mise activate zsh)"' >> ~/.zshrc
source ~/.zshrc

# Check if Nerd Font is installed
brew install --cask font-fira-code-nerd-font

# Set terminal font to "FiraCode Nerd Font"

MIT

tokichie