pruva-cli

Command-line interface for Pruva — manage your products, features, and documents from the terminal.

Designed for AI agents (Claude Code, Cursor, etc.) as a low-token alternative to MCP, but works great for humans too.

Installation

npm install -g pruva-cli

Or run directly with npx:

npx pruva-cli products list

Setup

Set your API key:

export PRUVA_API_KEY=<your-api-key>

Optionally set a custom base URL (defaults to https://www.pruva.ai):

export PRUVA_BASE_URL=https://staging.pruva.ai

Verify your configuration:

pruva-cli config

Agent Integration

Install skills for your AI coding agent:

# Claude Code
pruva-cli setup --claude

# Cursor
pruva-cli setup --cursor

Usage

All commands output token-efficient summaries by default. Add --json to any command for full JSON output.

Products

pruva-cli products list
pruva-cli products get <productId>

Features

pruva-cli features list <productId>
pruva-cli features get <featureId>
pruva-cli features create <productId> <title> [--brief "..."]
pruva-cli features update <featureId> [--title "..."] [--status "..."]

Documents

pruva-cli docs list <productId> [--type "..."] [--feature "..."]
pruva-cli docs get <documentId>
pruva-cli docs create <productId> --path "..." --content "..." --type "..." [--feature "..."]
pruva-cli docs create <productId> --path "..." --content-file ./spec.md --type "..."
pruva-cli docs update <documentId> [--content "..."] [--path "..."]
pruva-cli docs update <documentId> --content-file ./updated.md
pruva-cli docs search <productId> <query>

Relations

pruva-cli relations list <productId>

Ask (one-shot)

Ask the Pruva agent a question about a product. Prints the reply to stdout, followed by a dim line with token usage.

pruva-cli ask <productId> "What features does this product have?"
pruva-cli ask <productId> "Explain the login flow" --feature auth
pruva-cli ask <productId> "..." --json

Chat (interactive)

Start a multi-turn REPL session with the Pruva agent. Conversation history is kept in-memory for the duration of the session. Type exit, quit, or press Ctrl+D to end. Interactive — not pipe-safe.

pruva-cli chat <productId>
pruva-cli chat <productId> --feature auth --verbose

Output Formats

Default — token-efficient summary:

$ pruva-cli products list
2 products:
  Pruva (abc-123) — active, updated 2h ago
  SideProject (def-456) — active, updated 3d ago

JSON — full data, pipe-friendly:

$ pruva-cli products list --json
[{"id":"abc-123","name":"Pruva","state":"active",...}]

Pipe document content to a file:

pruva-cli docs get <documentId> > spec.md

License

MIT