Getting Started

Installation

Install Ralphy-Spec globally via npm:

npm install -g ralphy-spec

Or use npx without installing:

npx ralphy-spec init

Initialize in Your Project

cd your-project
ralphy-spec init

This will:

  • Create the openspec/ directory structure
  • Install tool-specific templates based on your selection
  • Create the local artifact folder ralphy-spec/ (STATUS/TASKS/BUDGET + state)

CLI Commands

See the full command reference (including run, status, budget, and flags like --artifact-dir):

Full CLI reference →

Workflow

1 Plan

Use /ralphy-plan to create OpenSpec from requirements

2 Implement

Use /ralphy-implement to build with Ralph loop

3 Validate

Use /ralphy-validate to verify acceptance criteria

4 Archive

Use /ralphy-archive to merge back to specs

Platform Guides