Skip to main content
The RedPill CLI manages your RedPill account. It is for people, shell scripts, and local agents that need a command-line interface; it does not send inference requests or replace Private AI Proxy.

​
Choose an account interface

Use one account interface on a given host, not both. Each keeps its own OAuth grant. MCP is the preferred agent integration because it provides typed tools and keeps API key creation in the browser; use the CLI when MCP is unavailable.

​
Install

Install Node.js 22.12 or newer, then install the CLI from npm. Node.js 24 LTS is recommended.
npm is the supported installation channel. Standalone binaries and install scripts are not currently published.

​
Sign in

The CLI opens RedPill in your browser and uses OAuth Authorization Code with PKCE. One login grants access to your user account and discovers every organization you can use. Choosing an organization or workspace changes local command context; it does not start another OAuth authorization.
Flags override saved defaults for a single command:

​
Capabilities

Run redpill --help or redpill <command> --help for options.

​
Automation and confirmations

Human-readable output is the default. Use --json for one complete JSON document on stdout; diagnostics and errors stay on stderr.
Commands that change remote data show a preview and ask for confirmation in an interactive terminal. In reviewed automation, use both --json and --yes:
--json disables prompts and fails before a mutation unless --yes is present. Use --no-input or REDPILL_NO_INPUT=1 to disable prompts while retaining human-readable output. OAuth login is interactive, so an agent should ask the user to run redpill auth login before continuing.

​
Configuration and credentials

The CLI stores local state in the RedPill configuration directory, following the XDG convention on Unix systems: Set REDPILL_CONFIG_HOME to override the directory. config.json contains organization and workspace defaults. credentials.json contains the OAuth grant and must not be shared or committed. On Unix systems, the directory is written with mode 0700 and both files with mode 0600; credential updates use atomic replacement. The CLI does not store RedPill API key secrets. A newly created key is shown once in command output, so treat that output as a secret. Agents must not run redpill key create because the secret would enter model context; ask the user to create the key in the dashboard instead.

​
Limits

Payments, subscriptions, organization membership, and administrator operations are intentionally not available through the CLI. Receipt verification must run in the client that sent the request.

Onboard your agent

Account MCP