Skip to main content
These four steps take you from a fresh install to an approved deployment plan. They’re the same whether you’re starting a new app or moving one that already runs somewhere else.

​
1. Install Monk

Run this in a terminal:
The installer finds the coding agents on your computer (Claude Code, Codex, Cursor and others), shows what it will change in each one and asks before changing anything. Then reload your agent so it picks Monk up. The installer tells you how for each agent, for example /reload-plugins in Claude Code.
Want to see the plan first? Add --dry-run and nothing is changed. More options.
To set up one agent by hand instead, follow its steps in Agents.

​
2. Sign in

You need a Monk account. Sign up at monk.io for a 5-day trial of Basic with no card. Signing in to the website and signing in your coding agent are separate steps. The installer offers the agent sign-in at the end. If you skipped it, your agent opens a browser sign-in the first time it uses Monk. To check that everything is in place, ask:

​
3. Ask for a plan

Open your app’s repository in your coding agent and ask:
Monk reads the repository and prepares a plan: the services, how they connect, any missing configuration and the estimated cost. Nothing is created yet. If the app already runs elsewhere, Monk plans a new environment alongside it and leaves the original alone. Moving data and switching traffic come later, and you review each one.

​
4. Review and approve

The plan opens in the local dashboard, a page served from your own computer. Check it there, then approve or decline. When Monk needs cloud credentials or other secrets, it opens a form in the same dashboard. Type or upload them there, never in the chat. After you approve, Monk provisions the infrastructure and deploys, and your agent reports the result.

Your first deployment, step by step

What each approval shows and what you get at the end

​
Next

Deploy an app that's already running

A new environment beside your current one

Start a new app

Build with your coding agent, deploy with Monk

The local dashboard

Where you approve plans and enter credentials

How Monk works

The plugin, the local companion and the orchestrator

​
Updating

Run the install command again. See Updating.

​
Uninstall

See Uninstall.