Back to App Store
App Store/ Infrastructure/ Miren

Miren

Miren · io.pilot.miren
Operate the Miren PaaS from an agent: deploy apps, run the server, and debug them.
Infrastructure Live on catalogue
Install
pilotctl appstore install io.pilot.miren
v0.1.0
Version
15
Methods
4.8 MB
Size
shareable
Sandbox
macOS · Linux
Platforms

About Miren

Miren is a deployment platform for small teams. This app is the app-store front door for the miren CLI, letting an agent drive a Miren PaaS over IPC.

What an agent gets: - Deploy lifecycle — miren.deploy (non-interactive build + deploy), miren.deploy.analyze (detect the stack/services without building), and miren.rollback. - Inspect apps — miren.apps, miren.app (status), miren.app.history, and miren.logs (JSON). - Server & diagnostics — miren.server.install/miren.server.status, miren.doctor, miren.whoami, and miren.debug.connection/miren.debug.advertise. - Full CLI surface — miren.exec runs any verbatim miren argv (addon, auth, env, route, cluster, disk, sandbox, and more).

Good to know: - Structured JSON is returned wherever the CLI offers it (e.g. pass --json). - Discover the live surface at runtime with miren.help — every method, its parameters, and its latency class (fast / med / slow). - Server-side commands need a configured cluster; without one, calls return a structured error ({stdout,stderr,exit}) telling the agent what to do next. - Runs on macOS and Linux (arm64 + amd64); the miren CLI is staged and sha-pinned on install.

Methods · 15

miren.exec
Run any miren subcommand. Payload is {"args":[...]} — the verbatim miren argv. Use this for the full CLI surface beyond the curated methods below (addon, auth, env, route, cluster, disk, sandbox, etc.). Run `miren help` or `miren <command> --help` for the surface. Example args: ["app","list","--json"]. Note: interactive subcommands (e.g. `app run`, `login`) and long-running ones (e.g. `server start`) are not suitable over IPC.
miren.apps
List all applications on the cluster (alias for `app list`).
miren.app
Show the current status of one application. Provide the app name.
miren.app.history
Show an application's deployment history.
miren.logs
Read recent logs for an application as JSON.
miren.deploy
Build and deploy the app in the current directory (non-interactive, --force).
miren.deploy.analyze
Analyze the app's detected stack/services without building or deploying.
miren.rollback
Roll an application back to its previous deployed version.
miren.doctor
Diagnose the miren environment and connectivity.
miren.whoami
Show the current authenticated user and cluster.
miren.server.install
Install the miren server as a systemd service on this host (Linux only).
miren.server.status
Show miren server service status (Linux only).
miren.debug.connection
Test connectivity and authentication with the miren server.
miren.debug.advertise
Show which addresses the server would advertise and why.
miren.help
Discovery: every method with params, kind, and latency class.

What’s New

v0.1.0 Latest
—
  • Operate the Miren PaaS from an agent: deploy and roll back apps; inspect status, logs, and history; run the server; and diagnose connectivity — plus a passthrough exec for any miren subcommand.

Platform Compatibility

macOS Apple Silicon
2.9 MBSupported
macOS Intel
2.8 MBSupported
Linux arm64
3.0 MBSupported
Linux amd64
3.0 MBSupported
You might also like

More in Infrastructure

Smol Machines
smol machines
Fast, hardware-isolated microVMs — local and cloud
macOS · Linux
Docker
Pilot Protocol
Run Docker from an agent — a local Docker Engine + CLI on Linux, real containers
Linux