@prxy/cli

Official command-line client for prxy.monster — the composable AI gateway.

$ prxy send "What is the capital of France?"
Paris.
(Used 12 input + 3 output tokens via claude-haiku-4-5. Cost: <$0.01)

Install

npm install -g @prxy/cli
# or
pnpm add -g @prxy/cli

Requires Node 22+. Uses native fetch — no axios bundled.

Quick start

# 1. Get a token from https://app.prxy.monster/keys
prxy login --token=prxy_xxxxxxxxxxxxxxxx

# 2. Confirm everything works
prxy doctor

# 3. Send your first request
prxy send "Hello!"

Or run the wizard:

prxy init

Command reference

| Command | What it does | |---|---| | prxy login [--token=] | Save a session token. Token paste only in v0.1.0; browser flow lands in v0.2.0. | | prxy logout | Wipe the saved session. | | prxy whoami | Show the current logged-in user. | | prxy keys list | List your active API keys. | | prxy keys create [name] | Mint a new key. The full key is printed once. | | prxy keys show <prefix> | Show details for one key. | | prxy keys delete <prefix> | Revoke a key. Prompts for confirmation; pass -y to skip. | | prxy pipeline show | Show the active module pipeline for your default key. | | prxy pipeline set <pipe> | Set a per-key pipeline override. Use default to clear. | | prxy pipeline test <pipe> | Preview a pipeline without saving. | | prxy usage today / month / by-model | Token + cost summaries. | | prxy billing balance | Show credits, tier, period end. | | prxy billing portal | Open the Stripe Customer Portal. | | prxy billing upgrade --tier=pro | Open Stripe Checkout for pro or team. | | prxy modules list | Browse the public module registry. | | prxy modules search <q> | Search modules by name, description, or tag. | | prxy modules info <name> | Full detail for one module. | | prxy bench | Run the local benchmark suite. | | prxy bench --remote | Benchmark your authenticated cloud endpoint. | | prxy doctor | Health check — config, endpoint, token, tier, pipeline. | | prxy init | First-run setup wizard. | | prxy send "<prompt>" | Send a one-off prompt; print the response. |

Run prxy <command> --help for full flag reference on any subcommand.

Config file

| Platform | Default path | |---|---| | macOS / Linux | ~/.prxy/config.json | | Windows | %APPDATA%\prxy\config.json |

Override with PRXY_CONFIG_DIR=/path/to/dir.

Schema:

{
  "endpoint": "https://api.prxy.monster",
  "token":    "prxy_xxx",
  "user":     { "id": "...", "email": "..." }
}

The file is written with mode 0600 (owner read/write only) on Unix.

Environment variables

| Variable | Purpose | |---|---| | PRXY_CONFIG_DIR | Override config directory (useful for CI / sandboxed installs). | | PRXY_REGISTRY_URL | Override the registry index URL for prxy modules. Defaults to the public GitHub raw URL. | | NO_COLOR | Disable colored output (no-color.org). |

Exit codes

The CLI follows POSIX-ish conventions so it's scriptable:

| Code | Meaning | |---|---| | 0 | success | | 1 | generic error (unexpected exception) | | 2 | not authenticated | | 3 | network unreachable | | 4 | server returned 5xx | | 64 | usage error (bad flags / args) |

Documentation

• Full docs: https://docs.prxy.monster/cli
• API reference: https://docs.prxy.monster/api
• Module marketplace: https://modules.prxy.monster
• Source: https://github.com/Ekkos-Technologies-Inc/prxy-monster/tree/main/packages/cli

License

MIT © ekkOS Technologies Inc.