[Extension]: Update Ralph Loop to v1.2.1 #3337

Note for triage: This is a version update of the existing community-catalog entry ralph (currently 1.1.1) → 1.2.1, not a brand-new extension. Filing via the Extension Submission template per the current catalog update process.

Extension ID

ralph

Extension Name

Ralph Loop

Version

1.2.1

Description

Autonomous implementation loop using AI agent CLI

Author

Rubiss

Repository URL

https://github.com/Rubiss-Projects/spec-kit-ralph

Download URL

https://github.com/Rubiss-Projects/spec-kit-ralph/archive/refs/tags/v1.2.1.zip

License

MIT

Homepage (optional)

https://github.com/Rubiss-Projects/spec-kit-ralph

Documentation URL (optional)

https://github.com/Rubiss-Projects/spec-kit-ralph/blob/main/README.md

Changelog URL (optional)

https://github.com/Rubiss-Projects/spec-kit-ralph/blob/main/CHANGELOG.md

Required Spec Kit Version

=0.8.5

Required Tools (optional)

• git - required
• copilot - optional, default agent CLI path
• codex - optional, supported agent CLI path
• claude - optional, supported agent CLI path

Number of Commands

2

Number of Hooks (optional)

1

Tags

implementation, automation, loop, copilot, codex, claude

Key Features

• Runs an autonomous Ralph implementation loop over the active feature's tasks.md.
• Spawns a fresh agent process for each iteration and persists progress through tasks.md and progress.md.
• Supports GitHub Copilot CLI, OpenAI Codex CLI, and Claude Code as configurable agent CLI backends.
• Supports Copilot dot-agent and skills-mode dispatch, including Spec Kit's nested integration_settings.copilot metadata.
• Provides Bash and PowerShell orchestrators with matching behavior and regression coverage.

Testing Checklist

• Extension installs successfully via download URL
• All commands execute without errors
• Documentation is complete and accurate
• No security vulnerabilities identified
• Tested on at least one real project

Submission Requirements

• Valid extension.yml manifest included
• README.md with installation and usage instructions
• LICENSE file included
• GitHub release created with version tag
• All command files exist and are properly formatted
• Extension ID follows naming conventions (lowercase-with-hyphens)

Testing Details

Release:

• GitHub Release: https://github.com/Rubiss-Projects/spec-kit-ralph/releases/tag/v1.2.1
• Release archive: https://github.com/Rubiss-Projects/spec-kit-ralph/archive/refs/tags/v1.2.1.zip
• Archive URL verified and downloaded; extension.yml in the archive reports version 1.2.1 and requires.speckit_version: ">=0.8.5".

Automated validation in the extension repository:

• bash tests/regression/bash/test-ralph-loop.sh → 79/79 passed
• pwsh -NoLogo -NoProfile -File tests/regression/powershell/Test-RalphLoop.ps1 → 69/69 passed
• bash -n scripts/bash/ralph-loop.sh
• git diff --check main...HEAD
• GitHub Actions Tests workflow passed for PR Fix formatting in usage instructions #24 before merge.
• GitHub Actions checks passed for release PR Performance consistency across context compaction events #26 before merge: Bash regression tests, PowerShell regression tests, and CodeQL.

Install validation with current Spec Kit CLI from github/spec-kit main:

1. Created a temporary Spec Kit project with specify init --here --integration copilot --script sh --ignore-agent-tools --force.
2. Installed from the release archive with specify extension add ralph --from https://github.com/Rubiss-Projects/spec-kit-ralph/archive/refs/tags/v1.2.1.zip --force and accepted the external-source prompt.
3. Verified specify extension list reports Ralph Loop (v1.2.1) with 2 commands and 1 hook enabled.
4. Verified the installed manifest reports version 1.2.1 and requires.speckit_version: ">=0.8.5".

Runtime dispatch validation:

• Confirmed the required Spec Kit floor should be >=0.8.5; v0.8.0 added Copilot --skills, but v0.8.5 is the first release that persists integration_settings.copilot.raw_options and invoke_separator for runtime dispatch.
• Tested fake Copilot full-loop dispatch against current Spec Kit nested integration_settings.copilot schema.
• Confirmed both Bash and PowerShell invoke Copilot skills mode as copilot -p "/speckit-ralph-iterate ..." and do not pass --agent speckit.ralph.iterate.

Example Usage

# Install from the v1.2.1 release archive
specify extension add ralph --from https://github.com/Rubiss-Projects/spec-kit-ralph/archive/refs/tags/v1.2.1.zip

# Run from an agent session that supports Spec Kit extension commands
/speckit.ralph.run --max-iterations 10

# Or run the Bash orchestrator directly
.specify/extensions/ralph/scripts/bash/ralph-loop.sh \
  --feature-name "001-my-feature" \
  --tasks-path "specs/001-my-feature/tasks.md" \
  --spec-dir "specs/001-my-feature" \
  --agent-cli "copilot"

Proposed Catalog Entry

{
  "ralph": {
    "name": "Ralph Loop",
    "id": "ralph",
    "description": "Autonomous implementation loop using AI agent CLI",
    "author": "Rubiss",
    "version": "1.2.1",
    "download_url": "https://github.com/Rubiss-Projects/spec-kit-ralph/archive/refs/tags/v1.2.1.zip",
    "repository": "https://github.com/Rubiss-Projects/spec-kit-ralph",
    "homepage": "https://github.com/Rubiss-Projects/spec-kit-ralph",
    "documentation": "https://github.com/Rubiss-Projects/spec-kit-ralph/blob/main/README.md",
    "changelog": "https://github.com/Rubiss-Projects/spec-kit-ralph/blob/main/CHANGELOG.md",
    "license": "MIT",
    "category": "code",
    "effect": "read-write",
    "requires": {
      "speckit_version": ">=0.8.5",
      "tools": [
        { "name": "copilot", "required": false },
        { "name": "codex", "required": false },
        { "name": "claude", "required": false },
        { "name": "git", "required": true }
      ]
    },
    "provides": {
      "commands": 2,
      "hooks": 1
    },
    "tags": ["implementation", "automation", "loop", "copilot", "codex", "claude"],
    "verified": false,
    "downloads": 0,
    "stars": 0,
    "created_at": "2026-03-09T00:00:00Z",
    "updated_at": "2026-07-04T18:50:14Z"
  }
}

Additional Context

This update moves the catalog entry from 1.1.1 to 1.2.1. Since the catalog's current 1.1.1 entry, Ralph has added:

• 1.1.2: hardened /speckit.ralph.run launcher argument handling.
• 1.2.0: official Claude Code support, Bash 3.2 agent CLI detection fixes, stricter completion-signal detection, and Copilot skills-mode dispatch for current Spec Kit integration_settings.copilot metadata.
• 1.2.1: corrected the extension manifest required Spec Kit version to >=0.8.5 and updated docs/examples to match.

Please preserve the existing created_at, downloads, and stars values from the current catalog entry.