@getpara/cli

@getpara/cli

The official CLI for Para. Authenticate, manage projects and API keys, scaffold new apps, and diagnose SDK issues — all from the terminal.

Install

npm install -g @getpara/cli

Or run directly with npx:

npx @getpara/cli <command>

Quick Start

para login                 # Sign in via the developer portal
para orgs switch           # Pick your organization
para projects switch       # Pick your project
para keys list             # View your API keys

Commands

Auth

Command	Description
para login	Sign in via the Para developer portal
para logout	Clear stored credentials
para whoami	Show current user, org, and project context

Resources

Command	Description
para orgs list	List your organizations
para orgs switch	Set the active organization
para projects list	List projects in your organization
para projects create	Create a new project
para projects switch	Set the active project
para keys list	List API keys for a project
para keys get <id>	Get details for a specific key
para keys create	Create a new API key
para keys rotate <id>	Rotate an API key

Setup

Command	Description
para create [name]	Scaffold a new Para-powered app (Next.js or Expo)
para init	Save current org/project/env to a .pararc file
para config get [key]	View configuration values
para config set <key> <value>	Set a configuration value
para config unset <key>	Remove a configuration value
para doctor [path]	Check a project for common SDK issues

Global Options

-e, --environment <env>  Target environment (DEV, SANDBOX, BETA, PROD)
--json                   Output as JSON
--org <id>               Organization ID override
--project <id>           Project ID override
-q, --quiet              Suppress non-essential output
--no-input               Disable interactive prompts (auto-detected in CI)

Authentication

The CLI supports three authentication methods:

• Browser login (default) — para login opens the developer portal for OAuth
• Environment variable — set PARA_TOKEN for scripts and CI
• Token file — set PARA_TOKEN_FILE to read a token from disk

Credentials are stored in ~/.config/para/credentials.json.

Configuration

Settings are resolved in order (first match wins):

• CLI flags (--org, --project, -e)
• Environment variables (PARA_ENVIRONMENT, PARA_ORG_ID, PARA_PROJECT_ID)
• Project config (.pararc in project root)
• Global config (~/.config/para/config.json)
• Defaults

More

• Para Documentation
• Developer Portal

Run para <command> --help for detailed usage on any command.