Rex

PRD management with hierarchical epics, features, tasks, and subtasks. LLM-powered analysis turns codebase findings into structured work items.

Data Model

Epic
  └── Feature
        └── Task
              └── Subtask

Each item has: id, title, status, priority, description, acceptanceCriteria, tags, blockedBy, timestamps.

Status: pending | in-progress | completed | failed

Priority: critical | high | medium | low

CLI

rex init .                           # initialize .rex/
rex status .                         # PRD tree with completion stats
rex next .                           # next actionable task
rex add "description" .              # smart add via LLM
rex add --file=ideas.txt .           # import from file
rex update <id> --status=completed . # update item
rex move <id> --parent=<parent-id> . # reparent item
rex remove <id> .                    # remove item and descendants
rex reshape .                        # LLM-powered PRD restructuring
rex prune .                          # remove completed subtrees
rex validate .                       # check PRD integrity
rex fix .                            # auto-fix common PRD issues
rex sync .                           # sync with remote adapter
rex usage .                          # token usage analytics
rex report .                         # JSON health report for CI
rex verify .                         # run acceptance criteria tests
rex analyze .                        # scan project, generate proposals
rex recommend .                      # show SourceVision recommendations
rex recommend --accept .             # add recommendations to PRD
rex reorganize .                     # detect and fix structural issues
rex health .                         # PRD structure health score
rex adapter list .                   # manage store adapters
rex mcp .                            # start MCP server (stdio)

Smart Add

rex add uses an LLM to decompose natural language descriptions into structured proposals:

rex add "Add SSO support with Google and Okta, admin config UI, audit logs" .

Produces structured epic/feature/task proposals with duplicate detection. When duplicates are found:

• Cancel — write nothing
• Merge — update matched items, add only non-duplicates
• Proceed — create duplicates with override markers

Recommend

rex recommend .                      # show findings
rex recommend --accept .             # add all to PRD
rex recommend --actionable-only .    # anti-patterns, suggestions, move-files only
rex recommend --acknowledge=1,2 .    # skip specific findings
rex recommend --acknowledge-completed .  # acknowledge completed tasks' findings

Baseline Detection

When scanning an existing codebase for the first time (empty PRD), Rex detects this as a baseline scan. The LLM marks:

• Completed — functionality already implemented in the code
• Pending — gaps and improvements to build

This prevents existing code from appearing as a wall of pending tasks.

Files

File	Purpose
.rex/prd.json	PRD tree (epics → features → tasks → subtasks)
.rex/config.json	Project configuration
.rex/execution-log.jsonl	Execution history (append-only, auto-rotated at 1 MB)
.rex/workflow.md	Human-readable workflow state
.rex/acknowledged-findings.json	Acknowledged SourceVision findings
.rex/pending-proposals.json	Proposals awaiting acceptance
.rex/archive.json	Pruned/reshaped item archive

MCP Tools

Available via rex mcp . (stdio) or ndx start . (HTTP). Claude Code prefixes these as mcp__rex__{tool}; Codex uses bare names.

Tool	Description
get_prd_status	PRD title, overall stats, and per-epic stats
get_next_task	Next actionable task based on priority and dependencies
update_task_status	Update item status
add_item	Add epic/feature/task/subtask
edit_item	Edit item content (title, description, priority, tags)
get_item	Full item details with parent chain
move_item	Reparent an item in the PRD tree
merge_items	Consolidate duplicate sibling items
get_recommendations	SourceVision-based recommendations
verify_criteria	Map acceptance criteria to test files
reorganize	Detect and fix structural issues
health	PRD structure health score
facets	List configured facets with distribution
append_log	Write structured log entry
sync_with_remote	Sync with remote adapter (e.g. Notion)
get_capabilities	Server capabilities and configuration