ralph-orchestrator

Before installation, ensure you have:

• jq - Required for statusline JSON parsing and settings management
• git - Recommended for git workflow features
• uv - Required for Python scripts (auto-installs dependencies via PEP 723)
• Platform-specific:

- macOS: coreutils (for gtac command used by statusline)

- Linux: coreutils (usually pre-installed, provides tac command)

The automated installer will detect and offer to install missing dependencies.

The easiest way to install the toolkit is using the interactive installer:

```bash

# Clone the toolkit

git clone https://github.com/YOUR_USERNAME/claude-code-toolkit.git

cd claude-code-toolkit

# Run the installer (auto-detects macOS or Linux)

./install.sh

```

Interactive Installation Modes

The installer offers flexible installation options:

1. Install All (Recommended)

• One-click installation of all components
• Fastest and simplest option
• Installs: skills, agents, commands, hooks, statusline, and settings

2. Select by Folder

• Choose which component types to install
• For each folder (skills/agents/commands/hooks), you can:

- All - Copy all items in that folder

- One-by-one - Review and select each item individually

- Skip - Skip that entire folder

• Perfect for customizing your installation

3. Skip Installation

• Exit without copying anything
• Useful if you just want to browse the code

What the Installer Does

• ✓ Checks for required dependencies (jq, git, coreutils, pip)
• ✓ Offers to install missing packages via package manager
• ✓ Creates necessary directories (~/.claude/*)
• ✓ Replaces existing skill folders (ensures clean updates, no file conflicts)
• ✓ Copies selected components with detailed logging
• ✓ Installs Python scripts (dependencies auto-managed by uv)
• ✓ Sets up statusline with proper permissions
• ✓ Installs damage-control security hooks (protects .env, credentials, blocks destructive commands)
• ✓ Installs concise-mode hook (brief responses, toggleable with /concise)
• ✓ Intelligently merges settings.json (preserves your existing settings)
• ✓ Configures Perplexity API key (searches environment and shell configs, or prompts for key)
• ✓ Automatically backs up hooks.json and settings.json to .bak files

Platform-Specific Installers

You can also run the platform-specific installer directly:

```bash

# For macOS

./install-mac.sh

# For Linux

./install-linux.sh

```

Non-Interactive Installation

Both installers support command-line options for non-interactive use:

```bash

# Install everything non-interactively

./install-linux.sh -y

# Install all, skip update check

./install-linux.sh -y --no-update

# Install all, skip UV installation (for damage-control)

./install-linux.sh --all --no-uv

# Show help

./install-linux.sh --help

```

Available options:

| Option | Description |

|--------|-------------|

| -y, --yes, --all | Auto-yes to all prompts (install everything) |

| --no-update | Skip Claude Code update check |

| --no-uv | Skip UV installation for damage-control hooks |

| --select | Interactive selection mode |

| --skip | Skip component installation |

| -h, --help | Show help message |

If you prefer manual installation or want selective components:

```bash

# Create directories

mkdir -p ~/.claude/{skills,agents,commands,hooks,scripts}

# Copy everything

cp -r skills/* ~/.claude/skills/

cp -r agents/* ~/.claude/agents/

cp -r commands/* ~/.claude/commands/

cp -r scripts/* ~/.claude/scripts/

cp hooks.json ~/.claude/hooks.json

cp statusline.sh ~/.claude/statusline.sh

chmod +x ~/.claude/statusline.sh

chmod +x ~/.claude/scripts/*.py

# Note: Python dependen