Pranor CLI Reference

The pranor command is the single entry point for all development and deployment tasks.

Usage

pranor <command> [options] [arguments]

Commands

Development

CommandDescription
pranor init <name>Create a new Pranor project
pranor run <file.pnr> [--watch]Run a .pnr service (with optional hot-reload)
pranor dev <file.pnr>Run with hot-reload enabled (alias for run --watch)
pranor build <file.pnr> -o <binary>Compile to a native binary
pranor test <file.pnr> [--cover] [--filter]Run test blocks
pranor lint <file.pnr>Static analysis and syntax checking
pranor fmt <file.pnr>Auto-format source code
pranor replInteractive Pranor shell

Package Management

CommandDescription
pranor add <package>Add a Go package dependency
pranor remove <package>Remove a package
pranor packagesList installed packages
pranor publishPublish to Pranor Hub registry

Deployment

CommandDescription
pranor deploy [--target docker|k8s]Deploy service to Docker or Kubernetes
pranor dockerize <file.pnr>Generate a production Dockerfile

Infrastructure

CommandDescription
pranor gateManage Pranor Gate (API gateway)
pranor pulseManage Pranor Pulse (message queue)
pranor cacheManage Pranor Cache
pranor meshManage Pranor Mesh (service discovery)
pranor tunnelManage Pranor Tunnel (dev tunneling)
pranor traceManage Pranor Trace (distributed tracing)
pranor lockAcquire/release distributed locks
pranor secretManage secrets (inject, unseal)

Tooling

CommandDescription
pranor bench <file.pnr>Generate load test scripts from routes
pranor doc <file.pnr>Generate HTML API documentation
pranor diff <old.pnr> <new.pnr>Detect breaking API changes
pranor migrateRun database migrations
pranor doctorDiagnose environment issues
pranor upgradeCheck for and apply Pranor updates
pranor auditScan dependencies for vulnerabilities

Global Flags

FlagDescription
--versionPrint Pranor version
--helpShow help for any command
--env <name>Set environment profile (dev, staging, prod)
--verboseEnable verbose output

Environment Variables

VariableDescription
PRANOR_HOMEPath to Pranor installation (runtime, stdlib)
PRANOR_OTLP_ENDPOINTOpenTelemetry collector URL for tracing
PRANOR_DISCOVERYJSON service discovery manifest

Examples

# Create and run a project
pranor init my-api
cd my-api
pranor run main.pnr --watch

# Build for production
pranor build main.pnr -o my-api --target linux/amd64

# Run tests with coverage
pranor test main.pnr --cover

# Deploy to Docker
pranor deploy --target docker

# Add a package
pranor add github.com/google/uuid