ralph

Launches and monitors autonomous task loops in cmux or tmux terminal sessions.

Updated Mar 9, 2026
One-click install
npx skills add https://github.com/hheydaroff/common-agent-skills --skill ralph-hheydaroff
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/hheydaroff/common-agent-skills/tree/main/skills/ralph
Command: npx skills add https://github.com/hheydaroff/common-agent-skills --skill ralph-hheydaroff

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill enables users to launch and manage autonomous loops of tasks within terminal panes, facilitating unattended operation and progress monitoring.

Core Features & Use Cases

  • Environment Detection: Automatically detects whether cmux or tmux is available for session management.
  • Task Execution: Executes a designated task source file like SPEC.md or tasks.json in a dedicated terminal pane.
  • Progress Monitoring: Enables real-time viewing of task progress and system status.
  • Use Case: A user wants to run a series of tasks defined in SPEC.md without manual oversight, monitoring progress in a split terminal.

Quick Start

To launch Ralph and monitor tasks, configure environment detection, specify your task file, and execute the generated script in your terminal emulator.

Frequently Asked Questions about ralph

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run autonomous task loops in a terminal multiplexer?

To run autonomous task loops, you configure environment detection, specify your task source file like SPEC.md or tasks.json, and execute the generated script in your terminal emulator to launch and monitor the automated process.

Does terminal automation work with both tmux and cmux?

Yes, terminal automation automatically detects whether cmux or tmux is available for session management, ensuring seamless execution and progress tracking in split terminal panes across both multiplexer environments.

How do I monitor progress of unattended automation workflows?

You monitor progress of unattended automation workflows by viewing real-time task execution and system status in dedicated split terminal panes managed by tmux or cmux session environments.

What is the best way to execute tasks defined in SPEC.md without manual oversight?

Executing tasks defined in SPEC.md without manual oversight is best handled by launching an autonomous task loop that runs the file in a dedicated terminal pane and tracks progress automatically.

Can I schedule task execution at specific intervals using terminal automation?

Yes, you can schedule task execution at specific intervals using terminal automation, which executes designated task source files like tasks.json within tmux or cmux multiplexer environments for unattended operation.