PRDForge CLI

The official command-line interface for PRDForge — generate, manage, and export AI-powered Product Requirements Documents from your terminal, CI pipeline, or AI agents.

PRDForge turns a product idea into a full blueprint in minutes: structured PRD, architecture, guardrails, and task breakdowns—ready for Cursor, Claude Code, Lovable, or any tool that speaks MCP. This CLI gives you the same power from the command line.

→ prdforge.dev · Web app (dashboard, API keys, export)

Installation

npm install -g prdforge
# or run directly
npx prdforge

Quick Start

# 1. Authenticate with your API key
prdforge auth login

# 2. Create a new PRD from a prompt
prdforge prd create --name "My App" --prompt "A task manager for remote teams"

# 3. Export to Markdown for Claude Code / Cursor
prdforge export <projectId> --format markdown

Authentication

Get your API key from the PRDForge dashboard: Dashboard → Settings → API Keys

Requires an active Pro or Starter subscription.

prdforge auth login          # Set your API key interactively
prdforge auth status         # Check authentication status
prdforge auth logout         # Remove stored key

You can also set PRDFORGE_API_KEY as an environment variable (useful for CI/CD and agents).

Commands

prdforge prd

prdforge prd list                          # List all projects
prdforge prd get <id>                      # Show all PRD sections
prdforge prd get <id> --section feature_list  # Show a specific section
prdforge prd create --name "App" --prompt "..."  # Generate a new PRD
prdforge prd update <id> --prompt "..."    # Smart-merge an update
prdforge prd refresh <id>                  # Regenerate stale stages

prdforge export

prdforge export <id>                       # Export as Markdown (default)
prdforge export <id> --format json         # Export as JSON
prdforge export <id> --output ./CLAUDE.md  # Custom output path
prdforge export <id> --stdout              # Print to stdout (pipe to files/agents)

prdforge watch

prdforge watch <projectId>                 # Poll project and re-export PRD.md when it changes
prdforge watch <id> -o ./PRD.md -i 60      # Custom output path and 60s interval

prdforge mcp

prdforge mcp serve                         # Run MCP server on stdio (for Cursor / MCP clients)

Exposes tools: prdforge_list_projects, prdforge_get_prd, prdforge_get_sections.

prdforge bulk

prdforge bulk ideas.csv                    # Generate PRDs from CSV (name, prompt columns)
prdforge bulk ideas.json --dry-run        # JSON array of { name, prompt }; --dry-run to preview
prdforge bulk ideas.csv --delay 5000      # Delay between each generation (ms)

prdforge config

prdforge config list                       # Show all config values
prdforge config set outputDir ./exports    # Change export directory
prdforge config set defaultFormat json     # Change default export format
prdforge config get outputDir

Agent / MCP Usage

The CLI is designed to work with AI agents and automation workflows:

# Example: Agent generates a PRD, pipes markdown to Claude Code
prdforge prd create --name "Scheduler" --prompt "$PROMPT" --json | \
  jq -r '.project.id' | \
  xargs -I{} prdforge export {} --stdout > CLAUDE.md

# Example: Bulk PRD generation from a list of ideas
cat ideas.txt | while read idea; do
  prdforge prd create --name "$(echo $idea | cut -c1-30)" --prompt "$idea"
done

Environment Variables

| Variable | Description | |----------|-------------| | PRDFORGE_API_KEY | Your API key (overrides stored key) | | PRDFORGE_API_URL | Custom API base URL (for self-hosted) |

Sync with Main App

See SYNC.md for notes on how this CLI stays in sync with the PRDForge web app and API.

License

MIT