setup

Chezmoi Setup Wizard

Overview

Interactive setup guide for chezmoi dotfiles management with age encryption and 1Password integration.

Capabilities:

• Guides through 5-phase setup
• Supports age encryption and 1Password integration
• Handles both new setup and clone existing scenarios

Use when: "set up chezmoi", "configure dotfiles", "initialize chezmoi", "first time setup", "new machine setup", "chezmoi初期設定", "dotfiles設定", "1Password連携", "初回セットアップ"

Don't use for: Updating existing dotfiles, syncing changes, checking status

5 Phases:

1. Environment check (tools availability)
2. Detect existing setup
3. Setup mode selection (new vs clone)
4. Guided setup (new machine or clone existing)
5. Verification

Execution

Follow the 5 phases sequentially. Read the Reference sections for detailed instructions.

Phase 1: Environment Check

Check if required tools are installed (see Reference: Phase 1 below).

Phase 2: Detect Existing Setup

Check if chezmoi is already configured (see Reference: Phase 2 below).

Phase 3: Mode Selection

Based on existing setup, ask user which mode to proceed with (see Reference: Phase 3 below).

Phase 4: Setup Guide

Based on selection:

• New setup (first machine): See Reference: Phase 4A below
• Clone existing (second+ machine): See Reference: Phase 4B below

Phase 5: Verification

After setup, verify everything works (see Reference: Phase 5 below).

Reference: Phase 1 - Environment Check

Check if required tools are installed:

echo "🔍 Checking required tools..."
echo ""

# Check chezmoi
if command -v chezmoi &> /dev/null; then
  echo "✅ chezmoi: $(chezmoi --version)"
else
  echo "❌ chezmoi: Not installed"
  echo "   Install with: brew install chezmoi"
fi

# Check age
if command -v age &> /dev/null; then
  echo "✅ age: $(age --version 2>&1 | head -1)"
else
  echo "❌ age: Not installed"
  echo "   Install with: brew install age"
fi

# Check 1Password CLI
if command -v op &> /dev/null; then
  echo "✅ op: $(op --version)"
else
  echo "⚠️ op: Not installed (optional)"
  echo "   Install with: brew install --cask 1password-cli"
fi

# Check GitHub CLI
if command -v gh &> /dev/null; then
  echo "✅ gh: $(gh --version | head -1)"
else
  echo "⚠️ gh: Not installed (optional)"
  echo "   Install with: brew install gh"
fi

echo ""