karimo-overview: Command for Claude Code

/karimo:greptile-review — Standalone Greptile Review Loop

Execute the full Greptile review cycle on a PR, looping until score meets threshold or circuit breaker triggers.

Arguments

• --pr <number> (required): The PR number to review.
• --threshold <1-5> (optional): Target score (default: from config.yaml or 5).
• --max-loops <1-30> (optional): Maximum revision attempts (default: from config.yaml or 3).
• --early-exit <1-5> (optional): Score at which to prompt for early exit (default: threshold - 1).
• --auto (optional): Skip early exit prompts. Continue to threshold or max loops.
• --no-prompt (optional): Alias for --auto. For CI/CD environments.

Usage

# Standard usage (reads config from config.yaml)
/karimo:greptile-review --pr 123

# Override threshold and max loops
/karimo:greptile-review --pr 123 --threshold 4 --max-loops 2

# Extended loop with budget-aware early exit
/karimo:greptile-review --pr 123 --max-loops 10

# Skip early exit prompts (CI/CD mode)
/karimo:greptile-review --pr 123 --max-loops 10 --auto

# Called by /karimo:merge (internal use)
/karimo:greptile-review --pr 123 --internal

Prerequisites

1. Greptile configured — review.provider: greptile in .karimo/config.yaml
2. Greptile GitHub App installed — On the repository
3. Repository indexed — In Greptile dashboard (app.greptile.com)
4. PR exists and is open — Cannot review closed or merged PRs

Behavior

Step 1: Initialize

# Load configuration
review_provider=$(yq '.review.provider' .karimo/config.yaml)
threshold=${THRESHOLD:-$(yq '.review.threshold // 5' .karimo/config.yaml)}
max_loops=${MAX_LOOPS:-$(yq '.review.max_revision_loops // 3' .karimo/config.yaml)}

# Validate Greptile is configured
if [ "$review_provider" != "greptile" ]; then
  echo "❌ Greptile not configured"
  echo "   Run: /karimo:configure --greptile"
  exit 1
fi

# Validate PR exists and is open
pr_state=$(gh pr view $pr_number --json state --jq '.state')
if [ "$pr_state" != "OPEN" ]; then
  echo "❌ PR #$pr_number is not open (state: $pr_state)"
  exit 1
fi

# Get PR metadata for context
pr_branch=$(gh pr view $pr_number --json headRefName --jq '.headRefName')
pr_base=$(gh pr view $pr_number --json baseRefName --jq '.baseRefName')
pr_title=$(gh pr view $pr_number --json title --jq '.title')

echo "╭────────────────────────────────────────────────╮"
echo "│  Greptile Review: PR #$pr_number"
echo "╰────────────────────────────────────────────────╯"
echo ""
echo "  Branch: $pr_branch → $pr_base"
echo "  Title: $pr_title"
echo "  Threshold: ${threshold}/5"
echo "  Max loops: $max_loops"
echo ""
echo "  Budget reminder: Greptile is \$30/month for 50 PRs, then \$1/PR after."
echo ""