setup:transitions

Add Session Progress Tracking

This command adds automatic hourly transition file tracking to your project.

What it does:

1. Creates .claude/hooks/init-transition.sh - Hook that creates hourly progress files
2. Updates .claude/settings.json - Adds UserPromptSubmit hook
3. Updates CLAUDE.md - Adds progress tracking instructions

Implementation

# Check we're in a project with .claude directory
if [ ! -d ".claude" ]; then
    echo "❌ No .claude directory found. Run /setup:existing first."
    exit 1
fi

echo "🔄 Adding session progress tracking..."
echo ""

# Create hooks directory
mkdir -p .claude/hooks

# Create the transition hook
cat > .claude/hooks/init-transition.sh << 'HOOK_EOF'
#!/bin/bash
# Initialize hourly transition file for session progress tracking
# This hook runs on UserPromptSubmit to ensure the hourly file exists
# Format: .claude/transitions/YYYY-MM-DD/HH.md (e.g., 19.md for 7pm hour)

set -e

# Get project root (where .claude/ directory is)
PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
TRANSITIONS_DIR="$PROJECT_ROOT/.claude/transitions"
TODAY=$(date +%Y-%m-%d)
HOUR=$(date +%H)
TODAY_DIR="$TRANSITIONS_DIR/$TODAY"
HOURLY_FILE="$TODAY_DIR/${HOUR}.md"

# Create today's transition directory if it doesn't exist
mkdir -p "$TODAY_DIR"

# Initialize hourly file if it doesn't exist
if [ ! -f "$HOURLY_FILE" ]; then
    cat > "$HOURLY_FILE" << EOF
# Session Progress: $TODAY ${HOUR}:00

---

EOF
fi

# Exit silently (hook output not visible to Claude anyway)
exit 0
HOOK_EOF

chmod +x .claude/hooks/init-transition.sh
echo "✅ Created .claude/hooks/init-transition.sh"

Now update settings.json to add the hook:

# Get absolute path to hook
HOOK_PATH="$(pwd)/.claude/hooks/init-transition.sh"

# Check if settings.json exists
if [ ! -f ".claude/settings.json" ]; then
    echo "❌ No .claude/settings.json found. Run /setup:existing first."
    exit 1
fi

echo "📝 Updating .claude/settings.json..."

I'll update the settings.json to add the UserPromptSubmit hook configuration. Let me read the current settings and merge the hook configuration.