shell-sync-setup

Chezmoi Shell Sync Checker Setup

Overview

Installs an interactive dotfiles sync checker that runs on shell startup.

Capabilities:

• Detects remote updates and local changes at shell startup
• Compatible with all zsh environments (plain zsh, oh-my-zsh, Powerlevel10k)
• Non-intrusive: Only shows status on empty Enter press
• Auto-updates via /plugin update

Use when: "set up shell sync", "install chezmoi checker", "enable startup check", "シェル同期チェッカー設定", "起動時チェック設定", "自動同期チェック"

Don't use for: Syncing dotfiles, committing changes, checking status

Features & Architecture

Features

• Checks for remote updates and local changes at shell startup
• Compatible with all zsh environments (plain zsh, oh-my-zsh, Powerlevel10k)
• Non-intrusive: Only shows status on empty Enter press
• Auto-updates via /plugin update (external script approach)

Architecture

Uses a minimal loader approach:

zshrc (7 lines)          External script (~150 lines)
┌─────────────────┐      ┌────────────────────────────────────────────┐
│ Loader snippet  │ ───► │ ~/.claude/plugins/.../shell-check.zsh     │
│ (source if      │      │ (auto-updated via /plugin update)         │
│  file exists)   │      └────────────────────────────────────────────┘
└─────────────────┘

Execution

Follow the 3 steps sequentially. Read the Reference sections for detailed instructions.

Step 1: Environment Detection & Migration Check

Detect environment and check for existing installation (see Reference below).

Step 2: Installation

Install the loader code into zshrc (see Reference below).

Step 3: Verification

Verify installation and troubleshoot if needed (see Reference below).

Reference: Environment Detection & Migration Check

Phase 1: Environment Detection

echo "🔍 Detecting environment..."
echo ""

SETUP_READY=true

# Check if zsh
if [[ -n "$ZSH_VERSION" ]]; then
  echo "✅ Shell: zsh $ZSH_VERSION"
else
  echo "❌ Shell: Not zsh (this setup requires zsh)"
  SETUP_READY=false
fi

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

# Detect zshrc location
ZSHRC_SOURCE=""
if [[ -f ~/.local/share/chezmoi/dot_zshrc ]]; then
  ZSHRC_SOURCE="$HOME/.local/share/chezmoi/dot_zshrc"
  echo "✅ zshrc source: chezmoi managed (dot_zshrc)"
elif [[ -f ~/.zshrc ]]; then
  ZSHRC_SOURCE="$HOME/.zshrc"
  echo "⚠️ zshrc source: ~/.zshrc (not chezmoi managed)"
else
  echo "❌ No zshrc found"
  SETUP_READY=false
fi

# Check external script availability
_s=(~/.claude/plugins/cache/claude-tools/chezmoi/*/scripts/shell-check.zsh(N.om))
if (( ${#_s} )); then
  echo "✅ External script: Found (${_s[1]})"
else
  echo "⚠️ External script: Not found in plugin cache"
  echo "   Make sure chezmoi plugin is installed from claude-tools marketplace"
fi

echo ""
echo "📋 Summary:"
echo "   Source file: $ZSHRC_SOURCE"
echo "   Ready:       $SETUP_READY"