Start for free

Set up Deckrun from your AI agent.

Paste one line into your coding agent. It installs the deck CLI, signs you in through your browser and deploys your repo to a Kubernetes cluster in your own DigitalOcean or Scaleway account.

Paste this into your agent
Set up Deckrun from deckrun.com/agents

Pick your agent. Each page has the steps for that agent.

Claude Codeby AnthropicCodexby OpenAICursorby Anysphere
OpenCode or another agent?Any agent that can run shell commands can follow the steps below.

How it works. You stay in control.

  1. ▶ Step 1

    Paste the prompt

    Your agent reads this page and installs the deck CLI if it’s missing.

  2. ▶ Step 2

    Approve, don’t paste

    You sign in to Deckrun in your browser, or sign up for free, and connect your cloud in your own terminal. No token goes through the chat.

  3. ▶ Step 3

    Say yes to the cluster

    The agent tells you what it will create in your cloud account and waits for your yes. Then it deploys and gives you the URL.

Your agent takes it from here. These are the steps it follows.

deckrun.com/agentsFor AI agents

For AI agents reading this page

The user sent you here to set up Deckrun. Deckrun deploys apps to a managed Kubernetes cluster that it creates in the user’s own DigitalOcean or Scaleway account. You operate it only through the deck CLI, never through the Deckrun API. Follow these steps in order.

If you are Claude Code, follow deckrun.com/claude instead.

If you are Codex, follow deckrun.com/codex instead.

If you are Cursor, follow deckrun.com/cursor instead.

  1. Install deck. Run deck version. If deck is not installed, run brew install deckrun/deck-cli/deck when Homebrew is available, otherwise curl -L https://deckrun.com/install-cli.sh | sh. If it is older than 2.1 (deck agent-guide is an unknown command), upgrade it with brew upgrade deck or by running the install script again.
  2. Sign in through the browser. Run deck auth login --output json in the background, show the user the URL from its first line, and wait for them to approve it in their browser. deck waits up to 15 minutes. A user with no Deckrun account signs up from that same page (the free plan needs no credit card), then opens the verification email in the same browser, which brings them back to approve. If the login fails with timeout, run it again and show the new URL: once signed in, it goes straight to the approval. If the result lists teams, ask the user which one to use and run deck switch <team-id>.
  3. Verify. Run deck providers list --output json. If it fails, stop and tell the user the error.
  4. Ask the user to connect their cloud. If no provider is listed, ask the user to run deck providers add in their own terminal. Their DigitalOcean or Scaleway token never goes through this chat.
  5. Read the guide. Run deck agent-guide and follow it from here on. It matches the installed deck, and has the workflow, every command with its flags, and the JSON each one returns.
  6. Confirm before creating a cluster. Before deck clusters create, tell the user the provider, region, node size and node count, say that it creates billable resources in their cloud account, and wait for an explicit yes.
  7. Deploy and report the URL. Run deck init and deck deploy as the guide says, and give the user the app’s URL.

Rules

  • The user signs up and approves access in their own browser. Never fill in a sign-up form, approve access or enter credentials for them, and never ask them to paste a Deckrun or cloud token into the chat.
  • Never run a destructive command (deck apps delete, deck clusters delete, deck domains delete, deck providers delete, deck secrets unset, deck auth logout). If the user wants one, give them the exact command to run in their own terminal.
  • Show the user every deck exec command and wait for their yes. Never open an interactive shell or print secret values.
  • If a step fails, stop and explain the error instead of improvising.

Reference