mio-agent

Mio Agent — background daemon for MioIsland's Slock-like AI workspace (private use).

This is an internal package for the MioMioOS ecosystem. It runs on a developer machine, bridges Claude Code / Codex sessions to the MioMioOS server, and powers the agent inbox + action runtime consumed by MioIsland clients.

Internal package. Published for installation convenience only. No external support, no public API guarantees, no semver promises. If you are not on the MioMioOS team, this is not for you.

Run in terminal mode (no global install — npx-cached)

You do NOT need a global install or a downloaded GitHub binary to run the daemon in pure-terminal mode. npx fetches + caches the package and launches the bin:

# 1. Pair this machine with prod (https://mio.wdao.chat) via QR + phone approval:
npx @miomioos/mio-agent@latest login

# 2. Run the daemon in the foreground (terminal mode), Ctrl-C to stop:
npx @miomioos/mio-agent@latest start

npx caches the resolved version, so subsequent start invocations launch without re-downloading. The published tarball ships only the compiled JS runtime (~0.2 MB packed) — the 36 MB SEA release binaries are for the MioIsland-managed install path and are NOT included here.

• terminal mode (start / run): the daemon runs in YOUR terminal/foreground; you own the process lifecycle. Good for dogfooding and headless boxes.
• MioIsland-managed mode (install --background --version <semver>): a version-pinned LaunchAgent/systemd service managed by the MioIsland app, which fetches the signed SEA release artifact. See the runbook below.

Requires Node.js >= 20.

Install (global)

npm install -g @miomioos/mio-agent

Quick commands

mio-agent --help        # list available subcommands
mio-agent login         # pair this machine with the MioMioOS server
mio-agent doctor        # diagnose runtime / auth / gateway health
mio-agent install       # install the daemon as a launchd / systemd service
mio-agent run           # foreground run (debugging)

After mio-agent install, the daemon runs in the background and reconnects to the MioMioOS gateway automatically.

Lifecycle / runbook

See docs/daemon-install-runbook.md in the source repository for the full install / uninstall / upgrade / log-collection lifecycle, including the launchd plist layout, log paths, and rollback steps.

For incident playbooks, gateway recovery, and the version pinning policy, see the operations notes in MioServer admin.

License

UNLICENSED — internal use within MioMioOS only.