Buncha Games Developer CLI

Command-line tools for approved Buncha Games developers who want to manage browser game listings without dashboard file-picker automation.

Use the CLI from your game repo. Do not use direct Cloudflare, R2, Supabase, database, or admin shortcuts.

Install

npm exec --yes --package @bunchagames/cli -- buncha-games --help

You can also use npx @bunchagames/cli ... in environments where npx is available.

Authenticate

Create a developer API token in the Buncha Games Developer Dashboard, then store it locally as BUNCHA_GAMES_API_TOKEN.

Do not print, echo, log, commit, or paste token values into chat.

$env:BUNCHA_GAMES_API_TOKEN = "paste-token-locally-only"

Common Workflow

# Inspect the current owned-game state.
npm exec --yes --package @bunchagames/cli -- buncha-games games status --site https://bunchagames.com --game-slug my-game --json

# Create a draft listing from a JSON manifest.
npm exec --yes --package @bunchagames/cli -- buncha-games games create --site https://bunchagames.com --manifest ./buncha-game-manifest.json --json

# Update listing metadata.
npm exec --yes --package @bunchagames/cli -- buncha-games games update --site https://bunchagames.com --game-slug my-game --manifest ./buncha-game-manifest.json --json

# Upload an exported browser build ZIP.
npm exec --yes --package @bunchagames/cli -- buncha-games upload --site https://bunchagames.com --game-slug my-game --file ./dist/my-game.zip --json

Media Commands

# Upload listing media.
npm exec --yes --package @bunchagames/cli -- buncha-games media upload --site https://bunchagames.com --game-slug my-game --type thumbnail --file ./media/thumbnail.webp --alt "Thumbnail showing the game title" --json
npm exec --yes --package @bunchagames/cli -- buncha-games media upload --site https://bunchagames.com --game-slug my-game --type hero --file ./media/hero.webp --alt "Hero image showing the main play area" --json
npm exec --yes --package @bunchagames/cli -- buncha-games media upload --site https://bunchagames.com --game-slug my-game --type screenshot --file ./media/screenshots/01.webp --alt "Gameplay screenshot of the first area" --json

# Move one media item by one slot.
npm exec --yes --package @bunchagames/cli -- buncha-games media move --site https://bunchagames.com --game-slug my-game --media-id <media-id> --direction up --json

# Set exact carousel order.
npm exec --yes --package @bunchagames/cli -- buncha-games media reorder --site https://bunchagames.com --game-slug my-game --media-ids <id-1>,<id-2>,<id-3> --json

# Remove one media item.
npm exec --yes --package @bunchagames/cli -- buncha-games media remove --site https://bunchagames.com --game-slug my-game --media-id <media-id> --json

Images must be JPG, PNG, WebP, or GIF and 8 MB or smaller.

Domains And Review

# Request external-domain review.
npm exec --yes --package @bunchagames/cli -- buncha-games domains request --site https://bunchagames.com --game-slug my-game --domain api.example.com --service-type other --service-name "Example API" --purpose "Loads public browser game data." --json

# Submit after the human confirms every attestation.
npm exec --yes --package @bunchagames/cli -- buncha-games review submit --site https://bunchagames.com --game-slug my-game --content-disclosure "No adult content, gambling, crypto, or sensitive content." --rights-confirmed --content-policy-confirmed --external-services-confirmed --terms-accepted --json

Review submission does not approve or publish a game automatically. It creates a developer-side submission for Buncha Games review.

games status --json Example

{
  "ok": true,
  "gameId": "00000000-0000-0000-0000-000000000000",
  "gameSlug": "my-game",
  "status": "sandbox_validated",
  "checklist": {
    "build": "validated",
    "media": "complete",
    "domains": "clear",
    "review": "ready"
  },
  "media": {
    "thumbnail": 1,
    "hero": 1,
    "screenshots": 3
  },
  "next": [
    {
      "label": "Open Sandbox",
      "href": "https://bunchagames.com/dev/games/<id>/sandbox"
    },
    {
      "label": "Submit for Review",
      "href": "https://bunchagames.com/dev/games/<id>/publish"
    }
  ]
}

Common Errors

• Missing token: set BUNCHA_GAMES_API_TOKEN locally and rerun the command without printing the token.
• Forbidden or not found: confirm the token belongs to the developer account that owns the game.
• Validation failed: rebuild a clean exported browser build and make sure index.html is at the ZIP root.
• Only Sandbox-validated games can be submitted: upload and validate a build before review submit.
• External domains unresolved: request or remove required domains before review submission.

More Docs

• Developer docs: https://bunchagames.com/developers/docs
• Manual upload path: https://bunchagames.com/developers/docs/upload-without-cli
• CLI guide: https://bunchagames.com/developers/docs/cli
• Agent quickstart: https://bunchagames.com/developers/docs/agent-quickstart