Copy page

CLI

The PokerWorks CLI is internal / coming soon for external developers. It currently ships as a repo-owned operator command for PokerWorks proof and support workflows, not as a public npm or npx package.

Closed-beta developers should use the Console and documented HTTP/OpenAPI contracts. Do not clone the private PokerWorks monorepo as part of a beta integration.

Install

Internal operators run:

Code
pnpm ops:developer-api -- --help

That command requires the private monorepo and repo toolchain. Public CLI packaging is a fast-follow after closed-beta proof.

Authenticate

Set your management token in the environment. The CLI never touches product calculation keys.

Code
export POKERWORKS_DEVELOPER_API_MANAGEMENT_TOKEN="pw_mgmt_…"

Production defaults to https://api.pokerworks.io/api/v1. Override the API base URL only for local or staging proof runs:

Code
export POKERWORKS_DEVELOPER_API_BASE_URL="http://localhost:3000/api/v1"

There is no public CLI login flow in closed beta. Create a service-account token in the console, store it in a secret manager or ignored env file, and pass --operator-env-file <path> for local runs when you do not want to export it in your shell. Project scoping is enforced by the token's project restrictions; commands that accept --project-id further narrow the operation.

Common commands

Code
# Read account state visible to the token
pnpm ops:developer-api -- account

# List or create projects
pnpm ops:developer-api -- projects list
pnpm ops:developer-api -- projects create \
  --name "Discord bot sandbox" \
  --allowed-origin "https://example.com"

# Update project allowed origins
pnpm ops:developer-api -- projects update \
  --project-id devproj_... \
  --allowed-origin "https://example.com" \
  --allowed-origin "https://admin.example.com"

# List, create, and revoke product API keys
pnpm ops:developer-api -- keys list
pnpm ops:developer-api -- keys create \
  --project-id devproj_... \
  --environment test \
  --label "CI smoke key" \
  --scope calculations:read
pnpm ops:developer-api -- keys revoke --key-id devkey_...

# Read usage, billing, and audit evidence
pnpm ops:developer-api -- usage --environment test --project-id devproj_... --limit 25
pnpm ops:developer-api -- billing
pnpm ops:developer-api -- audit-events --actor-type service_account --target-type developer_api_key

# List approved embed products and create a spectator embed session
pnpm ops:developer-api -- embeds products
pnpm ops:developer-api -- embeds sessions create \
  --project-id devproj_... \
  --environment test \
  --product-key pokerdeck-club-demo \
  --origin https://club.example.com

# Manage webhook endpoints and delivery evidence
pnpm ops:developer-api -- webhooks endpoints create \
  --project-id devproj_... \
  --environment test \
  --label "Discord announcements" \
  --url https://bot.example.com/pokerworks/webhooks
pnpm ops:developer-api -- webhooks deliveries list --project-id devproj_... --environment test

Proof commands intentionally require --confirm-billable-call because they create a temporary product key and run one metered calculation:

Code
pnpm ops:developer-api -- beta-proof \
  --project-id devproj_... \
  --environment test \
  --confirm-billable-call

Public status

The intended public package is not published yet. Until it is, treat this page as operator reference, not beta onboarding.

Related

• Service accounts & management tokens
• Recipes