Skip to content
minimachines

The setup guide

A little setup.
A lot more room.

From your terminal to your first cloud command. Install the CLI, connect your account, and bring your agent.

Install the CLI

You’ll need Node.js 20 or newer. Check with node --version, then install using your package manager.

Package manager
npm install --global @minimachines/cli@latest

When installation finishes, the mm command is available in your terminal.

Prefer to run without a global install?

Use npx --yes @minimachines/cli@latest in place of mm for each command. For example:

npx --yes @minimachines/cli@latest login

Sign in once

Run this command. Your browser opens so you can sign in and approve access for the CLI.

mm login

Return to your terminal after approval. The CLI saves your credential on this computer.

Need an account? Create one

Browser didn’t open?

Run mm login --no-open and open the URL printed in your terminal. If you have an API key set in MINIMACHINE_API_KEY, it takes priority over the saved login.

Bring your agent

Add the skill so your agent knows how to use Mini Machines. You can also use the CLI directly and skip this step.

Coding agent
mm skill install --agent codex

Writes to ~/.codex/skills/minimachine/SKILL.md

Restart your agent session to load the skill. Ask it to run a build or test on Mini Machines when you’re ready to use cloud compute.

Run your first command

Create a machine using the Node.js / TypeScript template.

This starts cloud compute.

Creating a machine may incur usage charges. Check your account before running this command, and stop the machine when you finish.

mm create node-ts

The command prints a machine ID and an app URL. Paste the ID below to personalize the next commands. This page doesn’t connect to your machine.

Copy the ID exactly as it appears in your terminal.

Check the runtime

mm exec MACHINE_ID 'node --version'

You should see the Node.js version installed on the machine. To open its browser console:

mm run MACHINE_ID

Finish up

Workspaces are temporary. Commit, push, or download anything you need before stopping the machine.

mm stop MACHINE_ID

Ready for more? Read the command reference