Documentation
Less setup.
More doing.
The essentials for driving a cloud workspace from your terminal.
Start with the install guideCommand reference
Use mm or minimachines. Replace MACHINE_ID with the ID printed when you create a machine. Commands run on your computer unless they are inside mm exec.
mm login- Sign in through your browser and save a CLI credential.
mm whoami- Show the saved credential source and API host. This does not validate the key with the server.
mm skill install --agent codex- Install instructions for your coding agent. Also supports claude and cursor.
mm create node-ts- Create a cloud machine from the Node.js / TypeScript template.
mm exec MACHINE_ID 'node --version'- Run a shell command and stream its output.
mm put MACHINE_ID ./index.html app/index.html- Upload a file to /workspace/app/index.html.
mm run MACHINE_ID- Open the machine’s browser console.
mm stop MACHINE_ID- Stop the machine. Save any work you need first.
Workspace basics
Files live in /workspace
Upload paths are relative to the workspace. For example, app/index.html becomes /workspace/app/index.html. Run commands from your project directory with mm exec MACHINE_ID 'cd /workspace/app && npm run build'.
App URL and console are different
The app URL points to port 3000. Start your app on 0.0.0.0:3000 before opening it. mm run opens the machine’s browser console instead.
Export before stopping
A machine is temporary compute, not durable storage. Push changes to your repository or download them before stopping. Keep credentials out of uploaded archives.
When something gets in the way
“mm: command not found”
Open a new terminal after installing. Check that your global package bin directory is on your PATH. You can also run the CLI without a global install:
npx --yes @minimachines/cli@latest loginThe CLI doesn’t recognize a command
Update to the latest CLI, then retry:
npm install --global @minimachines/cli@latestLogin opens the wrong account, or an API request is unauthorized
Run mm whoami to see the credential source and API host. This shows local configuration; it doesn’t validate the key. MINIMACHINE_API_KEY overrides saved credentials. Check that environment variable, then run mm login again if needed. Use https://www.minimachin.es as the API host.
My app URL isn’t loading
Check the server logs on the machine. Make sure the server is running, listening on 0.0.0.0, and using port 3000. Creating a machine doesn’t start your application automatically.
My agent doesn’t see the skill
Restart the agent session after installing. Check the file path shown in the agent setup step. For another agent, use mm skill install --dir PATH to write the skill to its instructions directory.