Skip to main content
mulerun computer is the umbrella for everything you can do with a MuleRun compute instance: spin one up, run a shell, execute a single command, or chat with the on-instance AI agent. This page is a quick overview. Detailed per-subcommand pages are coming soon.

​
Instance lifecycle

mulerun computer list                       # list instances
mulerun computer state <instance-id>        # detailed state
mulerun computer wakeup <id> --wait         # wake a suspended instance
mulerun computer reboot <id> --wait         # reboot a running instance
mulerun computer release <id> --yes         # release (economy suspend)
mulerun computer release <id> --force --yes # permanently destroy
mulerun computer quickfix <id>              # repair a stuck instance
For most commands the <instance-id> is optional: when omitted, the CLI auto-detects the first RUNNING instance (and will wake a SLEEPING one if that’s the only option).

​
Remote execution

# Execute a single command
mulerun computer exec <id> -- "ls -la"
mulerun computer exec -u ubuntu <id> -- "uptime"

# Interactive shell (WebSocket-backed)
mulerun computer shell <id>

# SSH (auto-generates and deploys a key pair)
mulerun computer ssh-setup <id>
mulerun computer ssh <id>
mulerun computer ssh <id> -u ubuntu -p 2222

# Generate a key pair only (local, no deploy)
mulerun computer ssh-keygen

​
ACP chat

Talk to the AI agent running on the instance over the ACP protocol. 
# Start a new chat (instance auto-detected)
mulerun computer chat --prompt "Write a Python hello world"

# Attach files
mulerun computer chat --prompt "Analyze this report" -f report.pdf

# Continue the conversation
mulerun computer send --prompt "Now make it print Hello MuleRun"
mulerun computer send --prompt "Continue" --session-id <session-id> --show-history
When no <instance-id> is provided, the CLI picks the first RUNNING instance (or wakes a SLEEPING one). Press Ctrl+C during a stream to cancel the prompt cleanly.

​
Filesystem operations

The fs subgroup talks to the instance’s filesystem over a JSON-RPC channel: 
mulerun computer fs list   <id> /path/to/dir
mulerun computer fs read   <id> /etc/hostname
mulerun computer fs write  <id> /tmp/out.txt --content "hi"
mulerun computer fs write  <id> /tmp/big.bin --from-file ./local.bin
mulerun computer fs mkdir  <id> /tmp/new-dir
mulerun computer fs rm     <id> /tmp/old --recursive
mulerun computer fs rename <id> /tmp/a /tmp/b
mulerun computer fs cp     <id> /tmp/a /tmp/b
mulerun computer fs search <id> /workspace --pattern "*.py"

​
Tips

  • --wait on wakeup / reboot blocks until the instance reaches RUNNING — useful when the next command needs the instance up.
  • release defaults to economy suspend (recoverable). --force makes it destructive; pair with --yes to skip the confirmation prompt only when you know what you’re doing.