autorun

autorun

Key Features

1. Fewer Interruptions: Claude/Gemini keeps working without "continue" prompts so you can step away
2. Verify Plans Before Starting: Plans get critiqued and refined before code is written
3. Implement, Evaluate, Verify: AI must pass all three stages. Prevents claiming half-done work is complete
4. Control AI File Creation: Choose whether AI can create files freely, must justify them, or edit-only
5. Dangerous Commands Get Redirected: rm becomes trash, git reset --hard becomes git stash
6. Works with Claude Code and Gemini CLI: Same commands, same safety, both platforms
7. 80+ Slash Commands: Plan auto-export, task tracking, git commit guidelines, design philosophy, and more
8. 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

• Key Features
• Quick Start
• UV Installation
  • Dual CLI Support (Claude Code + Gemini CLI)
• What autorun Does For You
• Why Byobu + tmux Integration
• AutoFile Lifecycle Flow
• How It Works
  • Three-Stage Autorun System
• Tmux Integration
• Development
• Available Commands
  • AutoFile (File Creation Control)
  • Command Redirecting
  • Autorun Commands (Autonomous Execution)
  • Plan Management Commands
  • Task Lifecycle Tracking
  • Documentation Commands
  • Tmux Automation Commands
  • Usage Examples
• CLI Reference
• Plugin Architecture and Integration Guide
• Tmux Automation Agents
• Project Structure
• Developer Documentation
• Dependencies
• Companion Tools
• Troubleshooting
• Contributing and Sharing
• References
• License

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