new

wiggum new <name> [options]

Starts an AI-guided interview to generate a detailed, project-aware feature specification. The spec is saved to .ralph/specs/<name>.md.

The interview

The interview has four phases:

Phase	What happens
Context	Share reference URLs, docs, or files relevant to the feature
Goals	Describe what you want to build
Interview	AI asks 3-5 clarifying questions about scope, edge cases, and constraints
Generation	Produces a detailed feature spec

name

string

required

Name for the feature spec. Used as the filename in .ralph/specs/.

--provider

string

AI provider for spec generation. Overrides the default.

--model

string

AI model to use for the interview.

-e, --edit

boolean

default:"false"

Open the spec in your editor after creation.

-f, --force

boolean

default:"false"

Overwrite an existing spec with the same name.

wiggum
# then type /new add-dark-mode in the TUI