Add interactive setup script with checkbox UI for streamlined installation

[orrgottlieb]

Summary

This PR introduces a comprehensive interactive setup script that dramatically simplifies the installation process for Claude Code skills, commands, and hooks. The new setup provides a modern checkbox-based UI for selective installation and automatic settings configuration.

Key Changes

1. Interactive Setup Script (setup.sh)

A full-featured bash script that provides:

• Interactive checkbox menus for selecting which items to install

  • Intuitive keyboard navigation (↑↓ to move, space to toggle, a to select all, n to deselect all)
  • Visual indicators showing already installed items (dimmed)
  • Only actionable items are selectable

• Multiple installation modes

  • Interactive mode (default): User-friendly checkbox selection
  • Batch mode (--all): Non-interactive installation of everything
  • Selective batch modes (--with-gemini, --no-gemini): Control optional components
  • Uninstall mode (--uninstall): Remove previously installed items with the same UI

• Automatic settings.json configuration

  • Registers SessionStart hooks automatically
  • Creates backup before modification
  • Uses proper nested structure with matcher and hooks array

• Smart detection

  • Identifies existing installations and skips them
  • Validates prerequisites (jq, ~/.claude directory)
  • Detects PATH configuration for scripts
  • Checks for GEMINI_API_KEY environment variable

• Enhanced UX

  • Color-coded output (info, success, skip, error)
  • Clear progress indicators
  • Comprehensive summary at the end
  • Help text with usage examples

2. Complete README Overhaul

Rewrote the installation section to:

• Feature the new setup script as the recommended method
• Provide clear examples for all installation modes
• Include keyboard shortcuts reference
• Document the uninstall process
• Maintain manual installation instructions as fallback
• Fix settings.json structure documentation (proper nested format with matcher)

3. Removed settings.json Template

• Eliminates the need for a separate template file
• Setup script now handles settings.json configuration automatically
• Reduces confusion about the correct configuration format
• Ensures consistent hook registration structure

Benefits

• Faster onboarding: One command (./setup.sh) instead of multiple manual steps
• Fewer errors: Automated configuration prevents copy-paste mistakes
• Better UX: Interactive UI makes selection intuitive and visual
• Flexibility: Supports both interactive and automated workflows
• Safer: Creates backups, validates prerequisites, handles edge cases
• Reversible: Built-in uninstall mode with the same intuitive UI

Test Plan

• ✅ Interactive installation with selective items
• ✅ Batch installation with --all
• ✅ Uninstall mode
• ✅ Skip logic for already installed items
• ✅ Settings.json configuration and backup
• ✅ Help text and error handling
• ✅ Color output and UI rendering

🤖 Generated with Claude Code