Smart Ralph plugin
A plugin for Claude Code and Codex: turns a feature request into a spec and executes it task by task with fresh context
- 566 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Autonomously writes code and changes project files
- Runs commands and quality checks in the execution loop
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/smart-ralphDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Autonomously writes code and changes project files
- Runs commands and quality checks in the execution loop
This is third-party code. Review the repository files before installing.
What it does
Smart Ralph drives development from a spec. From a feature request it builds research, requirements, design and a task list, then executes them one at a time, each with fresh context. The spec files stay in the project, so each phase can be reviewed and edited before execution. A large goal can first be split into dependency-aware specs through triage. Progress is recorded between tasks and work resumes after a stop. Each phase is run by a focused agent: research, product, architect, task planner, executor. An optional prototype tests one design question without turning throwaway code into production.
Who it is for. For developers who want to run a feature from a spec and keep an autonomous loop under control.
Good fit when
- You need to turn a feature request into a spec and execute it step by step
- A large goal needs splitting into dependency-aware specs
- You want an autonomous loop where each phase can be reviewed before execution
Not a fit when
- You need a one-off small change without a spec process
- You do not work in Claude Code or Codex
Example request
Build a spec for adding JWT authentication and execute the tasks one at a time with my approvalsLimitations
It targets Claude Code and Codex and does not work outside them. In Codex, automatic task execution needs the bundled Stop hook enabled, otherwise each task is run by hand. The autonomous loop writes code and runs checks, and the result needs review at approval points.
How to disable. Uninstall the ralph-specum plugin via /plugin in Claude Code or via codex plugin remove in Codex.
FAQ
What is quick mode?
With --quick, Smart Ralph generates all spec phases and moves straight to execution without stops between them.
Does it need external plugins?
No, the execution loop is self-contained and has no external plugin dependencies. In Codex, the bundled Stop hook enables automatic task execution.
Discussion
No questions or reviews yet.
Related
PluginsA Claude Code plugin: spec-driven development over a single SPEC.md file, a loop of seven commands with no sub-agents
A plugin for Claude Code: you read one spec and parallel agents ship it to a commit with green tests.
A Claude Code plugin for development with separated roles: spec, review, TDD, QA and verification by different agents
Claude Code plugin with 17 skills: task sizing, design review, TDD, fresh-context subagents and a PR after three human decisions.
A plugin with three skills for large development work: project analysis, phased tasks tracked as GitHub Issues, parallel agents and code review
The AI-SDLC plugin for Claude Code carries a task from spec to PR: a readiness gate, a developer agent and several reviewers.
README in short
The README describes Smart Ralph as a spec-driven development plugin for Claude Code and Codex that combines a Ralph-style loop with an ordered process. It creates research, requirements, design and task files before implementation, and splits large goals through triage. Specs stay in the project for review and edits, and progress persists between tasks. Each phase is run by a focused agent, with an optional prototype to test one design question. Install is through the plugin marketplace for Claude Code and codex plugin marketplace add for Codex. MIT licensed.