Commands Cheatsheet

Setup

# Install required tools
npm install -g @anthropic-ai/claude-code
curl -LsSf https://astral.sh/uv/install.sh | sh
brew install gh

# Auth
gh auth login

# Environment
cp .env.sample .env
# Fill in ANTHROPIC_API_KEY + GITHUB_PAT

# Health check
uv run adws/adw_tests/health_check.py

Run an ADW Manually

cd adws

# Level 1 — plan + build
uv run adw_plan_build.py <issue>

# Level 2 — + test
uv run adw_plan_build_test.py <issue>

# Level 3 — + review (no tests)
uv run adw_plan_build_review.py <issue>

# Level 4 — + test + review
uv run adw_plan_build_test_review.py <issue>

# Level 5 — full SDLC
uv run adw_sdlc.py <issue>
uv run adw_sdlc.py <issue> --skip-e2e
uv run adw_sdlc.py <issue> --skip-resolution

Run Individual Phases

cd adws

uv run adw_plan.py <issue>
uv run adw_build.py <issue> <adw-id>
uv run adw_test.py <issue> <adw-id>
uv run adw_test.py <issue> <adw-id> --skip-e2e
uv run adw_review.py <issue> <adw-id>
uv run adw_review.py <issue> <adw-id> --skip-resolution
uv run adw_document.py <issue> <adw-id>

Pipe Phases Together

cd adws

# Chain plan → build
uv run adw_plan.py 123 | uv run adw_build.py

# Chain plan → build → test
uv run adw_plan.py 123 | uv run adw_build.py | uv run adw_test.py

Parallel Execution

cd adws

uv run adw_plan_build.py 10 &
uv run adw_plan_build.py 11 &
uv run adw_plan_build.py 12 &
wait

Primitive ADWs (No GitHub Required)

# Ad-hoc prompt
uv run adws/adw_prompt.py "Add logging to the main module"
uv run adws/adw_prompt.py "Refactor auth" --model opus

# Run any slash command
uv run adws/adw_slash_command.py /chore "Add error handling"
uv run adws/adw_slash_command.py /implement specs/my-plan.md

# Chore + implement in one command
uv run adws/adw_chore_implement.py "Add health check endpoint"

# Interactive SDK session
uv run adws/adw_sdk_prompt.py --interactive
uv run adws/adw_sdk_prompt.py --interactive --session-id abc12345

Out-Loop Triggers

cd adws

# Cron polling (every 20 seconds)
uv run adw_triggers/trigger_cron.py

# Webhook server (port 8001)
uv run adw_triggers/trigger_webhook.py

Webhook Trigger Comments

Post these as GitHub issue comments to trigger a pipeline:

adw_plan_build
adw_plan_build_test
adw_plan_build_review
adw_sdlc

Debug

# View ADW state
cat agents/<adw-id>/adw_state.json

# View raw agent output
cat agents/<adw-id>/sdlc_planner/raw_output.jsonl | tail -1 | python3 -m json.tool

# List all run workspaces
ls agents/

# Enable verbose debug mode
export ADW_DEBUG=true
uv run adw_plan_build.py <issue>

ToDone Task System

# Start cron monitor
uv run adws/adw_triggers/adw_trigger_cron_todone.py

# Single pass
uv run adws/adw_triggers/adw_trigger_cron_todone.py --once

# Dry run
uv run adws/adw_triggers/adw_trigger_cron_todone.py --dry-run

Notion Prototyping

# Start Notion task monitor
uv run adws/adw_triggers/adw_trigger_cron_notion_tasks.py

# Single pass
uv run adws/adw_triggers/adw_trigger_cron_notion_tasks.py --once

# Dry run
uv run adws/adw_triggers/adw_trigger_cron_notion_tasks.py --dry-run

# Stop monitor
./scripts/kill_notion_cron.sh

Cleanup

# Remove a specific run workspace
rm -rf agents/<adw-id>

# Remove all run workspaces (keeps specs/)
rm -rf agents/*/

Environment Variables

Variable	Required	Description
ANTHROPIC_API_KEY	Yes	Claude API key
GITHUB_PAT	Yes	GitHub Personal Access Token
CLAUDE_CODE_PATH	No	Path to claude binary (defaults to claude)
GITHUB_REPO_URL	No	Override auto-detected repo URL
GITHUB_WEBHOOK_SECRET	No (webhook)	Webhook signature validation
ADW_DEBUG	No	Set to true for verbose output
CLOUDFLARE_R2_*	No	For uploading review screenshots to R2
NOTION_AGENTIC_TASK_TABLE_ID	No (Notion)	Notion database ID