⚡ Cursor Setup Guide

Installation

Initialize Ralphy-Spec with Cursor support:

cd your-project
ralphy-spec init --tools cursor

Or select Cursor during interactive setup:

ralphy-spec init

Ralphy-Spec creates the following files for Cursor:

.cursor/
└── prompts/
    ├── ralphy-plan.md
    ├── ralphy-implement.md
    ├── ralphy-validate.md
    └── ralphy-archive.md

In Cursor, use the slash commands to trigger each workflow phase:

Create an OpenSpec change proposal from your requirements or PRD.

Example: "Create an OpenSpec proposal for adding user authentication"

Implement tasks from the current OpenSpec change. Works with Ralph loop for iterative execution.

Example: "Implement the add-auth change"

Run tests and validate that acceptance criteria are met.

Example: "Validate the implementation meets all acceptance criteria"

Archive the completed change and merge specs back to source of truth.

Example: "Archive the add-auth change"

If you want to run ralphy-spec fully from a terminal and use Cursor for execution (--backend cursor), you must authenticate Cursor Agent first:

cursor agent login
cursor agent status

Then run the CLI:

ralphy-spec run --dry-run
ralphy-spec run --backend cursor

Backend output is streamed by default. Use --no-stream-backend to disable streaming.

Tip: for CI or non-interactive environments, set CURSOR_API_KEY instead of using cursor agent login.