cadre

A foreman for Claude Code

Supervises Claude Code so you don't have to. It handles permissions, reviews code, and runs quality gates automatically.

$ brew tap cdre-ai/tap && brew install cadre
macOS Linux
|

Then run: cadre "your task here"

Requires Claude Code to be installed.

Terminal 
$ cadre "add user authentication"

── cadre ──────────────────────────────────────────
  Mode: Hybrid (AI reviews writes, rules for rest)
  Task: add user authentication
  Est. cost: $0.30–$0.80

  Analyzing task complexity...
  Task is complex, planning subtasks...
  Planned 3 subtasks:
    [1] Add user model and database schema
    [2] Implement login/signup API endpoints
    [3] Add authentication middleware

  All 3 prompts ready

── Subtask 1/3: Add user model and database schema ──
  ✓ Allow: Write src/models/user.go (rule: trusted-path)
  ✓ Allow: Write src/db/migrations/001_users.sql (rule: trusted-path)
  ✓ AI → ALLOW: Bash go run migrate.go (safe: runs migration)
  ✓ Build passed
  ✓ Tests passed
  ✓ Code review passed
  ✓ Step complete
✓ Subtask 1/3 complete

── Subtask 2/3: Implement login/signup API endpoints ──
  ✓ Allow: Write src/handlers/auth.go (rule: trusted-path)
  ✗ AI → DENY: Bash curl http://production.api/test (unsafe: hits production)
  ✓ Build passed
  ✓ Tests passed
  ✓ Code review passed
  ✓ Step complete
✓ Subtask 2/3 complete

── Subtask 3/3: Add authentication middleware ──
  ✓ Allow: Write src/middleware/auth.go (rule: trusted-path)
  ✓ Build passed
  ✓ Tests passed
  ✓ Code review passed
  ✓ Step complete
✓ Subtask 3/3 complete

  All 3 subtasks completed successfully
  ✓ Comprehensive Review: PASS

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Task Complete                          Cost: $0.42
  3 subtasks • 47 tool calls • 12 files changed
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  [c] Commit  [v] View changes  [n] New task  [x] Exit

Smart Permissions

40 built-in rules handle known patterns instantly. AI reviews the rest. Dangerous commands get blocked. Safe edits flow through. Decisions are learned, so the AI is needed less over time.

9-Tier Code Review

Per-edit checks, batch reviews, comprehensive mid-session audits, and a final diff review before you commit. Build, test, and lint gates run automatically. Issues get caught early.

Task Decomposition

Complex tasks are split into focused subtasks, each with its own quality gates. Choose from built-in workflows (default, TDD, fix, refactor) or build your own.

Stay In Control

Pause and resume mid-task. Inject guidance while the AI works. Set a budget cap. Run in daemon mode for background execution. See cost estimates before you start.

How It Works

1

You give Cadre a task

"add dark mode support"

2

Cadre supervises Claude Code

Handles permissions, reviews code, runs quality gates, all automatically

3

You review the result

Commit, create a PR, iterate, or start fresh

Quick Reference

# Run interactively (recommended)
cadre

# Run with a task directly
cadre "add user authentication"

# Foreman modes
cadre "task" --rules-only     # No AI, fast and free
cadre "task" --review-all     # AI reviews everything

# Options
cadre "task" --budget 5.00    # Stop if cost exceeds $5
cadre "task" --workflow tdd   # Use TDD workflow
cadre "task" --pr             # Auto-create PR when done
cadre "task" --no-branch      # Don't create git branch

# Background & queue
cadre daemon "task"              # Run headless in background
cadre queue "a" "b" "c"          # Queue multiple tasks
cadre queue run                  # Process the queue

# Mid-task controls (while running)
# Ctrl+Z  pause/resume    g  inject guidance    d  diff stat