install

Install

Interactive setup wizard for the orc plugin. Uses AskUserQuestion for every decision point.

Process

Step 1: Welcome and Verify Claude Code

claude --version 2>/dev/null || echo "NOT_FOUND"

If NOT_FOUND: tell user to install Claude Code first, then re-run /orc:install.

Otherwise extract version. If < 1.0.33, warn that some features may not work.

Display welcome:

Welcome to orc — orchestrated planning and code review for Claude Code.

Step 2: Check plugin status

The fact that this skill is running means the plugin is loaded. Confirm this.

Determine context:

ls skills/install/SKILL.md 2>/dev/null && echo "IS_PLUGIN_REPO" || echo "IS_CONSUMER"

If IS_PLUGIN_REPO: Note they can load from any project with claude --plugin-dir /path/to/this/repo.

If IS_CONSUMER: Plugin is installed correctly.

Step 3: Script permissions and runtime setup

Discover all scripts and hooks that need execution access:

find skills/ .claude/skills/ -name "*.sh" -type f 2>/dev/null
ls .claude/hooks/index.ts 2>/dev/null && echo "HAS_HOOKS" || true

For each script found, present an AskUserQuestion with:

1. A description of what the script does
2. An ASCII diagram of its execution flow
3. A choice to grant execute permission or skip

Important: Check current permissions first with ls -la <path>. If already executable, note this and skip the question.

---

Script: skills/half-clone/scripts/half-clone-conversation.sh

What it does: Clones the later half of a Claude Code conversation into a new session, discarding earlier context to free tokens. Used by /orc:half-clone.

Present this to the user:

<AskUserQuestion>
  <Question
    question="Grant execute permission to half-clone-conversation.sh?"
    header="half-clone"
    multiSelect="false"
    options='[
      {"label": "Grant (Recommended)",
       "description": "chmod +x — required for /orc:half-clone to work",
       "preview": "half-clone-conversation.sh (575 lines)\n\nUsed by: /orc:half-clone\nRuntime: bash 3.2+ (macOS/Linux)\nInput:   session-id, project-path\nOutput:  new .jsonl conversation file\n\n┌─────────────────────────────────────┐\n│  /orc:half-clone                    │\n│  └─ calls half-clone-conversation.sh│\n└──────────────┬──────────────────────┘\n               │\n               ▼\n┌──────────────────────────────────┐\n│ 1. Find conversation .jsonl      │\n│    ~/.claude/projects/<dir>/     │\n│    └─ <session-id>.jsonl         │\n└──────────────┬───────────────────┘\n               │\n               ▼\n┌──────────────────────────────────┐\n│ 2. Count clean user messages     │\n│    Filter: type=user, skip meta  │\n│    Calculate halfway point       │\n└──────────────┬───────────────────┘\n               │\n               ▼\n┌──────────────────────────────────┐\n│ 3. Generate new session UUID     │\n│    Pre-generate UUIDs for awk    │\n│    (batch, not per-line)         │\n└──────────────┬───────────────────┘\n               │\n               ▼\n┌──────────────────────────────────┐\n│ 4. Single-pass awk transform     │\n│    ├─ Skip first N lines         │\n│    ├─ Remap session/msg UUIDs    │\n│    ├─ Strip thinking blocks      │\n│    ├─ Halve token counts         │\n│    └─ Tag first kept message     │\n└──────────────┬───────────────────┘\n               │\n               ▼\n┌──────────────────────────────────┐\n│ 5. Write new .jsonl + history    │\n│    ~/.claude/projects/<dir>/     │\n│    └─ <new-session>.jsonl        │\n│    ~/.claude/history.jsonl       │\n│    └─ append entry               │\n└──────────────────────────────────┘\n\nSafe: reads original, writes new file.\nNo destructive operations."},
      {"label": "Skip",
       "description": "Don't grant — /orc:half-clone won't work until you do"}
    ]'
  />
</AskUserQuestion>