Skip to content
CLIUnofficial

Inspired by Cloudflare's cf CLI · Unofficial

Manage Privy from your agent or terminal.

Apps, login methods, users, wallets, policies, webhooks and more. Everything you'd click through in the Privy dashboard, as one discoverable command line.

npm install -g @awesamarth/privy-cli
Get startedGitHub
# find the right command
$ privy cli search "enable google login"

# preview the change against your live app
$ privy --app APP_ID apps config update \
    --google-oauth true --diff

# apply it, then the CLI reads it back
$ privy --app APP_ID apps config update \
    --google-oauth true --yes

# inspect what's there
$ privy --app APP_ID users list
$ privy --app APP_ID webhooks list

What’s covered

Section titled “What’s covered”

Apps and login methods

Create dev apps, toggle email, passkey, wallet and OAuth logins, set up custom JWT auth and security settings.

Users and wallets

Search, inspect and paginate app users and wallets, with summaries by default and full rows on request.

Policies and key quorums

Create and edit wallet policies and rules, and inspect quorums and approvals.

Webhooks

Add endpoints and subscriptions, store signing keys safely and check delivery history.

Credentials and secrets

Create app API secrets and save them to an env file, your OS keychain, both or neither.

Accounts and analytics

Manage dashboard members and invitations, and read app analytics as JSON.

Designed for agents

Section titled “Designed for agents”

Every command works the same way:

  1. Discover: privy cli search "your task" finds the right command.
  2. Schema: privy schema <command> shows inputs, required confirmations and how the result is verified.
  3. Preview: --dry-run validates offline, and --diff shows the change against your live app without writing.
  4. Execute: --yes plus any confirmations the command needs. Nothing changes without them.
  5. Verify: the CLI reads the change back and tells you what it confirmed.

Output is JSON by default, guides work offline with privy docs, and secrets only ever go through stdin.

Use it with your agent

Section titled “Use it with your agent”

Install the skill so Claude Code, Codex, Cursor and other agents know when and how to use the CLI:

Terminal window
npx skills add awesamarth/privy-cli

Then ask: “Use the Privy CLI to create an app called my-new-test and enable Google login.” You’ll only need to log in yourself.

Install and log inInstall with npm, Bun, pnpm or Yarn and connect your Privy account.
Use it with your agentWhat the agent does, and what you still do yourself.

Not the agent-wallet CLI

Section titled “Not the agent-wallet CLI”

Privy’s official @privy-io/agent-wallet-cli gives an AI agent its own wallet to fund and transact with. This CLI manages your Privy developer account and apps. It never signs transactions or moves funds.

Privy CLI is an unofficial, community project by Samarth Saxena. Not affiliated with or endorsed by Privy. The Privy name and wordmark belong to Privy. It uses undocumented dashboard APIs that can change.