Build and deploy

Build and deploy an app with a coding agent

All help topics

Copy the prompt on your engine's Build with agents page, paste it into a coding agent on your computer and describe your app: the agent writes the code and deploys it to this engine.

  1. Open the engine and click Build with agents in the engine sidebar (or the Build with agents button at the top of Your apps and services).
  2. Optional, under Pick an agent: click Claude Code, Codex, Cursor, Antigravity (Google's, powered by Gemini) or Perplexity to read what it is and get a button to install it, like Get Claude Code. The prompt works in any of them, so you can skip this.
  3. On the card Use this prompt to build and deploy on your engine, click Copy prompt. Show full prompt lets you read it first.
  4. Paste it into your agent and describe the app you want after "The app I want:". If you leave that empty, the agent asks you before it writes any code.
  5. When the agent links the icp CLI, your browser opens a sign-in (often the console's Link your CLI page). Confirm and sign in with the identity you use for the console.
  6. The app then appears on Your apps and services.
Good to know
  • The prompt has the agent install three open-source skills (npx skills add dfinity/icskills --skill cloud-engine-canisters --skill deploy-to-cloud-engine --skill icp-cli) and carries your console's address, the engine's id and its subnet, so a copy works for this engine only.
  • Run the agent on your own computer: the sign-in can't finish from a cloud sandbox. An agent in the cloud needs the ICP MCP connector instead, and the prompt tells it so.
  • Every engine role (owner, admin, developer) can deploy apps.
  • Until the engine finishes setting up, the card says "The prompt appears here once this engine finishes setting up." and its button reads Engine still provisioning….
  • On an engine with no apps yet, Your apps and services shows the same prompt under No applications yet, with Copy prompt for your agent.
  • Rather write the code yourself? Under Other ways to build, Build it by hand holds the icp CLI steps and Upload a bundle.

More about the same page

Still stuck? Contact support