prdstack-agent

Local agent that bridges the PRDStack web app to your Claude Code CLI for AI-powered PRD generation.

What is this?

PRDStack is a web app for creating Product Requirements Documents using AI. By default it uses a cloud AI service, but with prdstack-agent you can use your own Claude Code subscription instead — giving you better performance, lower cost, and agent capabilities like local file generation.

Prerequisites

1. Claude Code CLI installed and authenticated:

   npm install -g @anthropic-ai/claude-code
   claude auth login

2. Node.js 18+

Usage

npx prdstack-agent

That's it. The agent starts on localhost:48373 and PRDStack auto-discovers it.

Options

prdstack-agent [options]

  --port <number>   Port to listen on (default: 48373)
  --help, -h        Show this help message

How it works

1. Run npx prdstack-agent in your terminal
2. Open PRDStack in your browser
3. Select Claude Code (Local) as your AI provider in the dashboard
4. Create PRDs as usual — all AI calls route through your local Claude Code

The agent:

• Runs an HTTP + WebSocket server on localhost only (never exposed to the network)
• Spawns Claude Code CLI as a subprocess for each AI request
• Streams responses back to the web app in real-time
• Tracks session IDs for multi-turn conversation continuity
• Reports actual costs from Claude Code (not estimates)

Features

• Streaming responses — See AI output as it's generated
• File generation — Create project planning files directly on your machine
• Multi-turn sessions — Conversation context preserved across requests
• Accurate cost tracking — Real costs from Claude Code, not estimates
• Auto-retry — Rate limit detection and graceful error handling
• Windows support — Full Windows compatibility with process management

Security

• The agent only binds to 127.0.0.1 — it's never accessible from the network
• Auth tokens are generated fresh on each startup
• Environment variables are filtered before passing to Claude Code subprocesses
• No API keys are stored or transmitted — Claude Code uses its own authentication

License

MIT