YOLO Mode Plugin for Claude Code
Transform Claude Code into a self-driving developer
YOLO Mode implements the Ralph Loop pattern for autonomous agentic coding. It plans, executes, and verifies complex tasks with minimal human intervention while maintaining context hygiene through fresh context windows.
✨ Features
- 🤖 Autonomous Loop: Takes a high-level prompt and runs until completion
- 🧠 Context Hygiene: Fresh Claude instances per task prevent context saturation
- 📝 Smart Planning: Auto-generates
YOLO_PLAN.md to track progress
- 🔊 TTS Feedback: Optional voice announcements via
tts-cli
- 💬 Interactive: Post-mission feedback loop for refinement
- ⚡ Zero-Trust/YOLO: Uses
--dangerously-skip-permissions for maximum autonomy
- 🎯 Dual Mode: Works as Claude Code plugin OR standalone CLI
- 🚀 Mini-SWE-Agent: Integrated support for the ~100-line AI agent (>74% SWE-bench)
🚀 Quick Start
Option 1: Claude Code Plugin (Recommended)
In Claude Code, add the marketplace and install the plugin:
/plugin marketplace add nbiish/yolo-mode
/plugin install yolo-mode@yolo-marketplace
If you install/enable/disable plugins during a session, run:
/reload-plugins
Use in Claude Code:
/yolo "Refactor the authentication system"
/yolo "Audit security" --agent opencode
/yolo-tts "Build a React component library" # With voice feedback
/yolo-guide "Focus on small diffs, add tests, and keep changes minimal"
/yolo-stop
Plugin Surface Area (what should appear in Claude Code):
- Skills (2):
yolo, yolo-tts
- Slash Commands (5 visible + 1 hidden):
/yolo <goal> - Start YOLO loop/yolo-tts <goal> - Start YOLO loop with TTS/yolo-mini <task> - Run a single task via Mini-SWE-Agent/yolo-guide <feedback> - Queue guidance for the next iteration/yolo-stop - Stop the loop and clear state/cancel-yolo - Hidden; resets iteration counter to 0
Option 2: Global CLI Tool
# Install from source
git clone https://github.com/nbiish/yolo-mode.git
cd yolo-mode
pip install -e .
# Run anywhere
yolo-mode "Your goal here" --tts
yolo-mode "Your goal here" --agent opencode
📖 Usage Examples
As Plugin (Inside Claude Code)
/yolo "Create a REST API with FastAPI"
/yolo-tts "Write unit tests for the utils module"
As CLI
# Basic usage (defaults to Claude Code)
yolo-mode "Implement user authentication"
# With OpenCode
yolo-mode "Refactor database schema" --agent opencode
# With Google Gemini
yolo-mode "Generate documentation" --agent gemini
# With Mini-SWE-Agent (NEW in v0.2.0)
yolo-mode "Write a sudoku game" --agent mini
/yolo-mini "Create unit tests for utils.py" # Slash command
# With voice feedback
yolo-mode "Build a dashboard" --tts
# Complex multi-step goal
yolo-mode "Set up a CI/CD pipeline with GitHub Actions, Docker, and AWS deployment"
🔧 Requirements
- Python 3.8+
- Supported Agents:
- Claude Code (default) -
npm install -g @anthropic-ai/claude-code
- OpenCode -
brew install opencode
- Gemini CLI
- Qwen
- Crush
- Mini-SWE-Agent -
pip install mini-swe-agent (NEW in v0.2.0)
- tts-cli (optional) - For voice feedback
🧠 Recommended Models (Cost/Quality)
YOLO Mode assumes your preferred provider + default model are already configured for each CLI tool (Claude/Gemini/OpenCode/etc.). When you can select a model (via a CLI flag or provider config), prefer:
⚠️ Anti-Stall & Zero Interaction
