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.
- 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).
- 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.
- On the card Use this prompt to build and deploy on your engine, click Copy prompt. Show full prompt lets you read it first.
- 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.
- 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.
- 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.