autorun
Key Features
- Fewer Interruptions: Claude/Gemini keeps working without "continue" prompts so you can step away
- Verify Plans Before Starting: Plans get critiqued and refined before code is written
- Implement, Evaluate, Verify: AI must pass all three stages. Prevents claiming half-done work is complete
- Control AI File Creation: Choose whether AI can create files freely, must justify them, or edit-only
- Dangerous Commands Get Redirected:
rm becomes trash, git reset --hard becomes git stash
- Works with Claude Code and Gemini CLI: Same commands, same safety, both platforms
- 80+ Slash Commands: Plan auto-export, task tracking, git commit guidelines, design philosophy, and more
- Learn From Mistakes: Analyze past sessions to find recurring AI failures, then turn them into permanent CLAUDE.md rules, skills, and hook blocks
Quick Start
# Install (requires UV - see UV Installation below)
uv pip install git+https://github.com/ahundt/autorun.git
autorun --install
# Verify installation
/ar:st
# Expected: "AutoFile policy: allow-all"
Plan & Execute (most common workflow):
/ar:plannew Design a REST API with authentication and tests
/ar:planrefine # Critique and improve the plan
/ar:planprocess # Execute the plan
/ar:go Build a login form with tests # Or run a task directly
File Policy (prevent file clutter):
/ar:f # Strict: only modify existing files
/ar:j # Justify: require justification for new files
/ar:a # Allow: create files freely (default)
Safety:
/ar:sos # Emergency stop
Works with both Claude Code and Gemini CLI — see Dual CLI Support.
Self-Improvement (learn from past sessions):
aise messages corrections --since 30d # Find recurring AI mistakes
aise analyze # Full qualitative analysis
# → Add findings to CLAUDE.md, skills, or hook blocks (see /ar:ai-session-tools Workflow 6)
Table of Contents
UV Installation (Recommended)
The autorun marketplace includes 2 plugins: autorun and pdf-extractor.
Note: plan-export functionality is now built into the autorun plugin. Use /ar:planexport commands for plan management.
GitHub Installation
Install the entire marketplace directly from GitHub:
# Install plugins from GitHub
uv pip install git+https://github.com/ahundt/autorun.git
# Register plugins with Claude Code
autorun --install
Local Installation
Install from a local clone:
# Clone repository
git clone https://github.com/ahundt/autorun.git
cd autorun
# Install marketplace
uv pip install .
# Register plugins with Claude Code
autorun --install
