@mantisware/miabot-agent
v0.1.58
Published
Pair a host or VM with a miaBot account
Readme
Machines
Scripts to stand up each computer kind and register it on a miaBot account.
The Machines tab registers placement only. A computer starts when a bot
needs a desktop or shell. Durability stays in AgentHomeStore, not the
provider VM.
Add in the app
- Sign in (personal desktop or hosted origin).
- Settings → Machines → Add
- Pick a kind. Pairing kinds show a code.
- On a paired host or VM (blank Ubuntu is fine after Node is installed):
npx --yes @mantisware/miabot-agent pair --code CODEPass --origin https://your-account.example or set MIABOT_ORIGIN. For a local account, pass --origin http://127.0.0.1:5173.
Keep that process running as a normal user. The hosted account sends shell and
file work to this process — same permissions as the user who launched it.
Workspaces live under ~/.miabot/computers. Live desktop preview is not
tunneled yet. --backend docker is only for a local container supervisor.
- Open a bot → Computer → Machine and select the row.
Agent is accepted as an alias:
npx --yes @mantisware/miabot-agent Agent pair --code CODE --origin URL.
Same RPC from this folder:
export MIABOT_ORIGIN=http://127.0.0.1:5173
export [email protected]
export MIABOT_PASSWORD=...
apps/machines/add.sh --kind docker
apps/machines/add.sh --kind pair --name LabDo not print those credentials.
Scripts
| Script | Kind | How it joins the app |
| --- | --- | --- |
| docker.sh | Docker pool | Settings → Add → Docker, or --add (machines/create) |
| desktop.sh | This computer | Personal app only. Settings → Add → This computer, or --add |
| pair.sh | Paired host | Settings → Add → Pair, then miabot-agent.sh pair |
| vm.sh | Paired VM | Settings → Add → Virtual machine, then pair inside the guest |
| parallels.sh | Parallels VM | --add uses adapter parallels |
| ssh-vnc.sh | Attached SSH+VNC | --add uses adapter ssh-vnc |
| firecracker.sh | MicroVM engine | .env SANDBOX_PROVIDER=firecracker (not an Add row) |
| e2b.sh | E2B engine | .env SANDBOX_PROVIDER=e2b + E2B_API_KEY |
| daytona.sh | Daytona engine | .env SANDBOX_PROVIDER=daytona + DAYTONA_API_KEY |
| box.sh | Box engine | .env SANDBOX_PROVIDER=box + BOX_API_KEY |
| miabot-agent.sh | Pairing client | machines/completePair on the host being added |
| add.sh | All Add rows | Shared create / beginPair helper |
fake is test-only. Do not add it on a real account.
Deployment engines (SANDBOX_PROVIDER) pick where new computers boot. Machines
rows pick a named placement on top of that. See
docs/self-host-sandbox-providers.md
and docs/computer-runtime.md.
