ralph-tasks

Manage a JSON task queue for the Ralph autonomous AI loop.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/cedricfressin/claude-config --skill ralph-tasks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-tasks
Source: https://github.com/cedricfressin/claude-config/tree/main/skills/ralph-tasks
Command: npx skills add https://github.com/cedricfressin/claude-config --skill ralph-tasks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes scripts (resource) components.

What problem does it solve?

This skill automates the management of a JSON-based task queue for the Ralph autonomous AI loop, enabling structured task intake, progress tracking, and execution.

Core Features & Use Cases

  • Task queue management: add, list, remove, and wake-up to run tasks.
  • Autonomous loop support: executes tasks one by one in sequence and maintains state.
  • Safe, atomic updates: uses jq for JSON updates to prevent corruption.
  • Use Case: A developer can add a task like "Implement OAuth" and have Ralph execute it through an iterative loop.

Quick Start

Start by initializing in the current project with /ralph-tasks setup. Then add a task with /ralph-tasks add "Implement user login". List tasks with /ralph-tasks list. Start the loop with sh .claude/ralph-tasks/wake-up.sh

Frequently Asked Questions about ralph-tasks

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

FAQPage Schema
How do I automate a JSON task queue for an autonomous AI loop?

You can automate a JSON task queue for an autonomous AI loop using shell scripts and jq to manage adding, listing, removing, and sequentially executing tasks. This ensures structured task intake and safe progress tracking.

How do I prevent JSON file corruption when updating tasks sequentially?

To prevent JSON file corruption during sequential task updates, use jq for atomic JSON updates within shell scripts. This ensures safe queue management and maintains state integrity throughout the autonomous loop.

Do I need jq installed to manage a shell-based task queue?

Yes, jq is a required dependency for managing this shell-based task queue. It handles the atomic JSON updates needed to safely add, remove, and modify tasks without corrupting the queue file.

What's the best way to run queued tasks one by one in an autonomous loop?

The best way to run queued tasks one by one is through a continuous wake-up shell script. This script processes your JSON task queue sequentially, executing each task while maintaining the loop's state.

How do I initialize a task queue in my current project?

Initialize a task queue in your current project by running the setup command. After initialization, add tasks to the JSON queue and trigger the autonomous wake-up loop to start sequential execution.

Can I add and remove specific tasks from a JSON queue using shell scripts?

Yes, you can add and remove specific tasks from a JSON queue using dedicated shell scripts. Combined with jq, these scripts safely modify the JSON task list, allowing structured management before the autonomous loop executes them.