KUMODeck

More

Copy as Markdown

Support

Email [email protected] for help with KUMODeck.

Please include your project's name, what you asked the assistant or ran, and the error code if one was shown. Check the quick answers first.

Common problems#

Quick answers#

Claude or ChatGPT says KUMODeck is not connected#

Add KUMODeck Preview (v0.2) again from the + in the message box: in Claude, + → Connectors, then turn KUMODeck Preview (v0.2) on again; in ChatGPT, type @ and pick KUMODeck Preview (v0.2). Then ask again. With an AI agent on your computer, start a new conversation after connecting.

"Allow this tool?" keeps coming back, or Publish does nothing#

Claude asks the first time it uses each tool. Press Always allow, or set every KUMODeck tool to Always allow under Customize → Connectors → KUMODeck Preview (v0.2) → Tool permissions. In ChatGPT, choose to remember it for this conversation. If you pressed Publish and nothing moves, write "I pressed it" in the conversation.

Using an invite code#

Anyone can sign up; an invite code is optional. It adds $5 of invite credit for usage fees once your email address is confirmed. Enter it at sign-up, or later under Billing on the dashboard or with kumodeck billing redeem <code>. One code per account.

Creating or publishing waits for the balance#

KUMODeck is prepaid. A new account without an invite code starts at $0, so creating, publishing and AI features wait until you add funds. If the balance reaches $0, billed parts pause and new deployments are refused with 402. Add funds on the dashboard or with kumodeck billing topup; everything resumes once the balance is above $0. Automatic top-up prevents pauses.

My game's address does not open#

If your balance reached $0, players see a neutral "temporarily unavailable" message until you top up. If you changed its slug with --no-redirect, old links show "Not found". If a new version is broken, ask your AI: "Roll production back to the previous one." See Hosting.

An error code or a limit#

Errors carry a code, a message and often a hint that names the next command, so your AI can usually fix it. For a size or count, details.limit has the number. On 429, wait details.retryAfter seconds and retry once. See Limits.

Deleting a project or closing your account#

The dashboard's Account page lists your projects with a delete button. Deleting always asks you first. To close your account, delete your projects, then close it on the dashboard or with kumodeck account close in your own terminal. It cannot be reopened. See Closing your account.

A leaked key or a security issue#

If a secret key leaks, create a new key in the dashboard, update your CI and revoke the old key; revocation is immediate. Report security issues privately by email, not in public. See Security model.

What to include in your email#

  • The email address you sign in with, and your project's name.
  • Where you were: Claude, ChatGPT, Muse, Claude Code, Codex, Cursor or the KUMODeck CLI.
  • What you asked the assistant, or the command you ran.
  • The error code and message, if one was shown.
  • The address of the page that does not open.
  • What you expected to happen.

Never send a secret key or a password.