@miosa/cli

The official MIOSA command-line interface. Deploy apps and manage OpenComputers hosts from your shell.

npm install -g @miosa/cli

Deploy — 60 seconds to first deploy

Point the CLI at any repo and it handles the rest: framework detection, build wiring, GitHub webhook setup, and live log streaming.

$ cd ~/my-project
$ miosa login
$ miosa deploy

  Detected: Next.js 15 (confidence 95%)
  Repo:     https://github.com/me/my-project
  Branch:   main

? Deployment name: my-project
? Branch to deploy: main
? Build command: npm run build
? Run command: npm start
? Create deployment? Yes

  Deployment "my-project" created (slug: my-project-x7k2)
  Saved .miosa.json

  ACTION REQUIRED — GitHub Webhook
  The webhook secret below is shown ONCE. Store it now.

  Webhook URL:   https://api.miosa.ai/api/v1/integrations/github/webhook
  Content type:  application/json
  Secret:        a3f8b2c1d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9
  Events:        push

  Add this at: https://github.com/me/my-project/settings/hooks/new

  Initial build queued

  Build log:
  ────────────────────────────────────────────────────────────
  > npm run build
  > next build
  ✓ Compiled successfully
  ────────────────────────────────────────────────────────────

  Deployed

  URL:    https://my-project-x7k2.me.miosa.app

  Next steps:
    miosa deploy logs                          — tail logs
    miosa deploy domain add example.com        — add custom domain
    miosa deploy env set KEY=VALUE             — set env var

On subsequent runs from the same directory, miosa deploy reads .miosa.json and skips all prompts — just queues a rebuild and streams logs.

# Trigger a rebuild any time
miosa deploy

# Or explicitly
miosa deploy redeploy

Deploy sub-commands

miosa deploy list                          # All deployments for this tenant
miosa deploy logs [id]                     # Tail live build logs
miosa deploy redeploy [id]                 # Manual rebuild
miosa deploy env set KEY=VALUE [--id id]   # Set env var
miosa deploy env list [id]                 # Show env vars (masked)
miosa deploy domain add example.com [id]   # Add custom domain
miosa deploy destroy [id]                  # Tear down deployment

Supported frameworks (auto-detected)

| Framework | Detection | Build | Run | |---|---|---|---| | Next.js | next in package.json | npm run build | npm start | | SvelteKit | @sveltejs/kit in package.json | npm run build | node build | | Vite + React | vite + react in package.json | npm run build | npx serve dist | | Phoenix (Elixir) | mix.exs with :phoenix | mix release | _build/prod/rel/.../bin/... start | | Django | manage.py + requirements.txt | pip install + collectstatic | gunicorn | | Flask | requirements.txt with flask | pip install | gunicorn app:app | | Ruby on Rails | Gemfile + config/application.rb | bundle install | rails server | | Go | go.mod | go build -o app . | ./app | | Rust | Cargo.toml | cargo build --release | ./target/release/<name> | | Static HTML | index.html (no build system) | — | npx serve . |

OpenComputers hosts

# Authenticate
miosa login

# List your hosts
miosa hosts

# Open an interactive terminal
miosa ssh my-mac

# Run a command
miosa exec my-mac "npm test"

# Upload a file
miosa cp ./build.tar.gz my-mac:/tmp/

# Expose a port publicly
miosa tunnel open my-mac --port 3000

Configuration

Config is stored at ~/.miosa/config.json:

{
  "endpoint": "https://api.miosa.ai",
  "api_key": "msk_u_...",
  "default_host": null
}

Precedence: CLI flags > environment variables > config file > interactive prompt.

Environment variables:

| Variable | Description | |---|---| | MIOSA_API_KEY | API key (overrides config file) | | MIOSA_ENDPOINT | API endpoint (overrides config file) | | MIOSA_DEBUG | Set to any value to enable debug output |

Commands

miosa deploy [sub-command]

Deploy a GitHub repo. See the Deploy section above for the full flow.

miosa deploy                             # First deploy or redeploy from .miosa.json
miosa deploy list [--json]               # List all deployments
miosa deploy logs [id]                   # Tail live build logs
miosa deploy redeploy [id] [--no-follow] # Manual rebuild
miosa deploy env set KEY=VALUE [--id id] # Set env var
miosa deploy env list [id]               # Show env vars (masked)
miosa deploy domain add <domain> [id]    # Add custom domain
miosa deploy destroy [id] [-f]           # Tear down deployment

miosa login [--api-key key]

Authenticate with your MIOSA API key. If no key is provided, you'll be prompted interactively.

miosa login
miosa login --api-key msk_u_yourkey
echo "msk_u_yourkey" | miosa login   # non-TTY / CI

miosa logout

Remove the stored API key.

miosa hosts [--json]

List all registered hosts.

miosa hosts
miosa hosts --json | jq '.[].name'

miosa host <name-or-id> [--json]

Show details for a specific host including live telemetry.

miosa host my-mac
miosa host abc12345

miosa connect [name]

Register a new host interactively. Prints the install command and waits for the host to come online.

miosa connect
miosa connect my-new-server

miosa ssh <host> [--cmd "..."]

Open an interactive PTY terminal session on a host.

miosa ssh my-mac
miosa ssh my-mac --cmd "ls -la"

miosa exec <host> <cmd> [args...] [--cwd dir] [--env KEY=VAL] [--timeout 30s]

Run a command non-interactively and stream output. Exits with the remote exit code.

miosa exec my-mac npm test
miosa exec my-mac ls -- -la /tmp
miosa exec my-mac env --env NODE_ENV=production --env PORT=3000
miosa exec my-mac make build --cwd /home/user/project --timeout 10m

miosa cp <src> <dst>

Copy files between local and remote. Use host:/path for remote paths.

# Upload
miosa cp ./local.txt my-mac:/tmp/
miosa cp -r ./dist my-mac:/var/www/

# Download
miosa cp my-mac:/var/log/app.log ./
miosa cp my-mac:/home/user/report.pdf ~/Downloads/

miosa ls <host>:<path> [-a] [-l]

List files on a host.

miosa ls my-mac:/tmp
miosa ls my-mac:/home/user -la
miosa ls my-mac:/ -a

miosa rm <host>:<path> [-r] [-f]

Remove a file or directory on a host. Prompts for confirmation unless -f.

miosa rm my-mac:/tmp/old-build.tar.gz
miosa rm -rf my-mac:/tmp/build-artifacts

miosa tunnel open <host> --port <n> [--name slug] [--watch]

Expose a port on a host publicly.

miosa tunnel open my-mac --port 3000
miosa tunnel open my-mac --port 8080 --name my-app --watch

miosa tunnel list <host>

List active tunnels on a host.

miosa tunnel close <host> <slug>

Close (revoke) a tunnel.

miosa agent <host> "<task>" [--model] [--steps] [--timeout]

Dispatch an AI agent task. Streams thoughts, tool calls, and results live.

miosa agent my-mac "run the test suite and fix any failing tests"
miosa agent my-mac "update all npm dependencies" --steps 20
miosa agent my-mac "optimize the database queries" --model nemotron-3-super

miosa watch <host>

Stream live telemetry and events from a host.

miosa watch my-mac

miosa status

Show current auth, endpoint, tenant info, credits, and host count.

miosa status

Exit codes

| Code | Meaning | |---|---| | 0 | Success | | 1 | User error (bad args, not found, etc.) | | 2 | Network error | | 3 | Authentication error | | 4 | Server error |

Troubleshooting

"No API key configured" — Run miosa login.

"Host not found" — Check miosa hosts for the correct name or ID.

"Insufficient credits" — Top up at https://miosa.ai/billing.

Network errors — Check your connection. Use MIOSA_DEBUG=1 miosa <cmd> for stack traces.

Custom endpoint — MIOSA_ENDPOINT=https://your-instance.ai miosa hosts

Links

• Documentation: https://docs.miosa.ai/cli
• Platform: https://miosa.ai
• Support: [email protected]

License

MIT