Frankbria Agents

mentioning "5-hour limit" Custom Prompts # Use custom prompt file ralph --prompt my_custom_instructions.md # With integrated monitoring ralph --monitor --prompt my_custom_instructions.md Execution Timeouts # Set Claud...

ory Session Auto-Reset Triggers: Circuit breaker opens (stagnation detected) Manual interrupt (Ctrl+C / SIGINT) Project completion (graceful exit) Manual circuit breaker reset ( --reset-circuit ) Session expiration (d...

3 loops with no file changes CB_SAME_ERROR_THRESHOLD=5 # Open circuit after 5 loops with repeated errors CB_OUTPUT_DECLINE_THRESHOLD=70 # Open circuit if output declines by >70% CB_COOLDOWN_MINUTES=30 # Minutes before...

er system. After installation, you can delete the cloned repository if desired. Phase 2: Initialize Projects (Per Project) Option A: Enable Ralph in Existing Project (Recommended) cd my-existing-project # Interactive...

N → HALF_OPEN → CLOSED Provides detailed error tracking and logging with state history Auto-recovery options: # Default: 30-minute cooldown before auto-recovery attempt CB_COOLDOWN_MINUTES=30 # Set in .ralphrc (0 = im...

rectory Add reusable patterns and conventions .ralphrc Yes (project-aware) Rarely edit (sensible defaults) Key File Relationships PROMPT.md (high-level goals) ↓ specs/ (detailed requirements when needed) ↓ fix_plan.md...

Code - Runs Claude Code with current context and priorities Track Progress - Updates task lists and logs execution results Evaluate Completion - Checks for exit conditions and project completion signals Repeat - Conti...

or PRD documents Configures Settings - Set tool permissions and loop parameters Generates Files - Creates .ralph/ directory and .ralphrc configuration Verifies Setup - Confirms all files are created correctly Non-inte...

nts (.docx) - Business requirements PDFs (.pdf) - Design documents, specifications Any text-based format - Ralph will intelligently parse the content Usage Examples # Convert a markdown PRD ralph-import product-requir...

rom your system: # Run the uninstall script ./uninstall.sh # Or if you deleted the repo, download and run: curl -sL https://raw.githubusercontent.com/frankbria/ralph-claude-code/main/uninstall.sh | bash Understanding...

cts Claude's explicit intent) Loop 8: Claude outputs "All tasks complete, project ready" → completion_indicators: 4 → EXIT_SIGNAL: true (Claude confirms done) → Result: EXIT with "project_complete" Other exit conditio...

ts.md (technical specs) # Start autonomous development ralph --monitor Option C: Create New Project from Scratch # Create blank Ralph project ralph-setup my-awesome-project cd my-awesome-project # Configure your proje...

hourly: Setting Default Description MAX_CALLS_PER_HOUR 100 Max Claude invocations per hour MAX_TOKENS_PER_HOUR 0 (disabled) Max cumulative tokens per hour Token tracking extracts input_tokens + output_tokens from each...

experience ralph --monitor --live # Live output is written to .ralph/live.log tail -f .ralph/live.log # Watch in another terminal Live streaming mode shows Claude Code's output in real-time as it works, providing visi...

ngs MAX_CALLS_PER_HOUR=100 CLAUDE_TIMEOUT_MINUTES=15 CLAUDE_OUTPUT_FORMAT= " json " # Token budget per hour (0 = disabled). One Claude call can use 100k+ tokens. # MAX_TOKENS_PER_HOUR=500000 # Tool permissions ALLOWED...

permissions Standard Ralph structure - All necessary directories and template files in .ralph/ The conversion is intelligent and preserves your original requirements while making them actionable for autonomous develop...

features Solutions BY COMPANY SIZE Enterprises Small and medium teams Startups Nonprofits BY USE CASE App Modernization DevSecOps DevOps CI/CD View all use cases BY INDUSTRY Healthcare Financial services Manufacturing...

GitHub - frankbria/ralph-claude-code: Autonomous AI development loop for Claude Code with intelligent exit detection · GitHub Skip to content Navigation Menu Toggle navigation Sign in Appearance settings Platform AI C...

complete removal Live Streaming Output - Real-time visibility into Claude Code execution with --live flag Quick Start Ralph has two phases: one-time installation and per-project setup . INSTALL ONCE USE MANY TIMES +--...

jects with best-practice structure Interactive Project Setup - ralph-enable wizard for existing projects with task import Configuration Files - .ralphrc for project-specific settings and tool permissions Comprehensive...

rces.sh v0.10.1 - Bug Fixes & Monitor Path Corrections Fixed ralph_monitor.sh hardcoded paths for v0.10.0 compatibility Fixed EXIT_SIGNAL parsing in JSON format Added safety circuit breaker (force exit after 5 consecu...

examples lib lib logs logs specs/ stdlib specs/ stdlib src src templates templates tests tests .gitattributes .gitattributes .gitignore .gitignore CLAUDE.md CLAUDE.md CONTRIBUTING.md CONTRIBUTING.md IMPLEMENTATION_PLA...

ern CLI for PRD Import Modernized ralph_import.sh to use Claude Code CLI JSON output format Enhanced error handling with structured JSON error messages v0.9.7 - Session Lifecycle Management Complete session lifecycle...

to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert {{ message }} frankbria /...

S Enterprise platform AI-powered developer platform AVAILABLE ADD-ONS GitHub Advanced Security Enterprise-grade security features Copilot for Business Enterprise-grade AI features Premium Support Enterprise-grade 24/7...

new tests for permissions and parameter forwarding v0.11.1 - Completion Indicators Fix Fixed premature exit after exactly 5 loops in JSON output mode completion_indicators now only accumulates when EXIT_SIGNAL: true A...

usly executes Claude Code with your project requirements Intelligent Exit Detection - Dual-condition check requiring BOTH completion indicators AND explicit EXIT_SIGNAL Session Continuity - Preserves context across lo...

ions Added 13 new regression tests for progress detection and checkbox regex v0.11.3 - Live Streaming & Beads Fix Added live streaming output mode with --live flag for real-time Claude Code visibility (#125) Fixed bea...

tr (#187) Added 8 new tests for API limit detection (548 → 566 tests) v0.11.4 - Bug Fixes & Compatibility Fixed progress detection: Git commits within a loop now count as progress (#141) Fixed checkbox regex: Date ent...

e for project settings Live streaming output with --live flag for real-time Claude Code visibility Multi-line error matching for accurate stuck loop detection 5-hour API limit handling with user prompts tmux integrati...