miridev-cli

Official CLI for miri.dev — deploy static sites in seconds, get a live URL, connect your own domain.

npm i -g miridev-cli

Quick start

miridev login                     # browser login (required for permanent hosting + projects)
miridev deploy --project my-site  # 1st time → https://my-site-<shortid>.miri.dev
miridev deploy                    # after that → same fixed URL, latest version

• Any static folder works — put an index.html at the root (a lone .html file is auto-detected as index). Subfolders (assets/, img/) are served as-is; no flattening needed.
• Login = permanent hosting. Guest deploys are temporary.
• Projects = fixed URL. The first --project deploy writes .miri-project.json; later miridev deploy reuses it, so the URL never changes and always serves your latest deploy.

Custom domains (paid plan)

Connect your own domain (e.g. shop.mybrand.com) to a project. Paid plan + SMS verification required.

miridev domains add shop.mybrand.com --project my-site-<shortid>   # interactive SMS verification
miridev domains ls                                                  # list your domains

The command verifies your phone by SMS, registers the domain, and auto-provisions a TLS certificate. It then prints one DNS record — add it at your domain's DNS provider (proxy off):

CNAME  shop  →  miridev.fly.dev   (DNS only)

Within a few minutes your domain is live over HTTPS and follows the project's latest deploy. Run from the project folder (reads .miri-project.json) or pass --project <subdomain>.

Commands

| Command | Description | | --- | --- | | miridev login | Browser login | | miridev deploy [--project <name>] [--dir <path>] [-m <notes>] | Deploy a folder (fixed URL with --project) | | miridev domains add <domain> [--project <subdomain>] | Connect a custom domain (paid + SMS) | | miridev domains ls | List your custom domains | | miridev sites | List your deployed sites | | miridev status | Deployment status | | miridev init | Create miri.config.js |

Verify a deploy

curl -s -o /dev/null -w "%{http_code}\n" https://my-site-<shortid>.miri.dev/          # index
curl -s -o /dev/null -w "%{http_code}\n" https://my-site-<shortid>.miri.dev/some.jpg  # an asset

Both should be 200. If the index is 200 but assets 404, re-check paths / that files uploaded (a partial upload can leave only index.html).

Links

• Website: https://www.miri.dev
• LLM/agent guide: https://www.miri.dev/llms.txt
• MCP (natural-language deploys): https://www.npmjs.com/package/miridev-mcp

MIT