CLI

Install and use the LEAPERone CLI to sign in, create API keys, check credits, inspect endpoints, and read docs from your terminal.

The LEAPERone CLI lets you discover the live API catalog without signing in, then manage API keys, credits, and account access with a scoped control token.

Installation

No installation required. Run it with npx:

npx @leaperone/cli

Or install it globally:

npm install -g @leaperone/cli

After a global install, both leaperone and the short alias lpr are available.

Authentication

npx @leaperone/cli auth login

This opens your browser for authentication. If you are on a headless server or remote machine, use Device Flow:

npx @leaperone/cli auth login --device

Check your current auth status:

npx @leaperone/cli auth status

Log out and remove stored credentials:

npx @leaperone/cli auth logout

Commands

API Keys

# List all API keys
npx @leaperone/cli apikey list

# Create a new API key
npx @leaperone/cli apikey create -n "my-app-key"

# Revoke an API key by name
npx @leaperone/cli apikey revoke -n "my-app-key"

When you create a new API key, it is displayed only once. Save it immediately.

Credits

# Check your current credit balance
npx @leaperone/cli credit balance

# View recent usage history
npx @leaperone/cli credit usage

# Show last 50 records
npx @leaperone/cli credit usage -l 50

Public Discovery

Browse the live API catalog without signing in:

# List all API endpoints
npx @leaperone/cli --json endpoints list

# Search the current model catalog
npx @leaperone/cli --json models search grok

# List and read documentation
npx @leaperone/cli --json docs list
npx @leaperone/cli docs read quickstart

# Show configured URLs and check public API catalogs
npx @leaperone/cli --json doctor

Upgrade

If you installed the CLI globally, upgrade it from the terminal:

# Upgrade the global install
leaperone upgrade

# Short alias also works
lpr upgrade

If you use npx, run the latest package directly:

npx @leaperone/cli@latest

JSON Output

All commands support a --json flag for machine-readable output, useful for scripting and CI pipelines:

npx @leaperone/cli credit balance --json
lpr credit balance --json

Example JSON output

{
  "paid": 10.0,
  "gift": 5.0,
  "total": 15.0,
  "giftExpiresAt": "2026-04-01T00:00:00.000Z"
}

Agent Skills

LEAPERone CLI bundles Agent Skills — reusable instruction sets that help AI coding assistants (Claude Code, Cursor, Codex, Windsurf, etc.) understand how to use LEAPERone.

Quick Install

# View install guide
npx @leaperone/cli skills

# Auto-discover from node_modules (recommended)
npx skills-npm

# Or install via skills CLI
npx skills add $(npx @leaperone/cli skills path)

# Or manual copy (Claude Code)
cp -r $(npx @leaperone/cli skills path)/leaperone-cli ~/.claude/skills/

What It Does

Once installed, your AI agent knows how to:

Authenticate and manage API keys
Check credit balance and usage
Integrate OpenAI-compatible, Anthropic-compatible, media, and data APIs
Discover live documentation, models, pricing, and endpoint status

Supported Agents

Skills work with 40+ AI coding assistants including Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, Gemini CLI, and more.

Environment Variables

Control-plane automation uses a scoped lpc_ token:

export LEAPERONE_CONTROL_TOKEN=lpc-your-control-token
npx @leaperone/cli credit balance

Application requests under /v1/* use a separate sk- model API key, commonly stored as LEAPERONE_API_KEY. The CLI still accepts that variable for limited legacy control-plane compatibility, but emits a warning and does not recommend it for new automation.

With --json, parse stdout only. Warnings are written to stderr.

On this page