Skip to content

MuleRun CLI

MuleRun CLI is the command-line tool for MuleRun. Under a single login it gives you a multimodal generation surface — images, video, speech, music — plus a coding agent, and lets you drive your sessions, Computer, Drive, and Pages from the terminal. It's also how a Super Agent task dispatches work to your Computer behind the scenes.

Full docs: https://mulerun.com/docs/cli/quickstart

Install

Install globally with npm (Node.js required):

bash
npm install -g @mulerunai/cli
mulerun --version

bun and pnpm, as well as one-off npx usage, are also supported.

Log In

bash
mulerun login

This opens a browser for OAuth. The token is cached locally, and every other command reuses it — you only log in once per machine.

Main Commands

  • mulerun studio — multimodal generation (images, video, speech, music). Example:

    bash
    mulerun studio run openai/gpt-image-2/generation \
      --prompt "A vector logo of a fox, flat style" \
      --size "1024x1024"
  • mulerun code — launches an interactive coding-agent CLI under the same login.

  • mulerun session / computer / drive / page — manage your sessions, Computer, Drive, and Pages from the terminal.

Output

Most commands print readable text by default; add -o json for JSON. Streaming responses go to stdout, status messages go to stderr — so you can pipe results cleanly in scripts.

Common Questions

Do I need to log in for every command? No. After mulerun login, the token is cached locally and reused by all commands.

Which package managers are supported? npm, bun, and pnpm for a global install, or npx for a one-off run.

MuleRun Help Center