Reference

Install the plugin. Connect the CLI.

Your Amp key and GitHub token are set up on Overview. This page covers what happens on your own machine.

Install the plugin
Amp loads a copy of the plugin, not a symlink. From your MacOrb checkout:
```
mkdir -p .amp/plugins
cp -R plugin/macorb .amp/plugins/macorb
```
To use it in every project instead of one, put it in Amp’s system plugin directory — $XDG_CONFIG_HOME/amp/plugins/macorb when that variable is set, otherwise ~/.config/amp/plugins/macorb.
Then reload plugins in Amp, or restart it. This console cannot see your plugin directory, so it cannot confirm the install. node cli/macorb.mjs doctor can: it asks Amp itself whether the plugin loaded, and checks the token file and the API.
Connect the CLI
One command, from the same checkout:
```
node cli/macorb.mjs login
```
It opens this console, waits on a loopback port on this computer, and writes ~/.config/macorb/token with mode 0600 after you confirm one prompt in the browser.
On a headless box, or a browser that cannot reach 127.0.0.1, copy your token and pass it directly with login --token.
Your first task
In an Amp thread on a project with the plugin loaded, type:
```
Build and test this on a Mac
```
Amp acquires a Mac and starts a child thread on its registered runner. The command palette has the same thing as MacOrb: Run on the Mac.
To drive a Mac from a terminal instead, start one with node cli/macorb.mjs up. Once it reports the runner registered it prints the command that attaches to it:
```
amp --executor runner:<runner-id>
```
Amp documents this flag; we have not yet measured it against a MacOrb Mac. It attaches to a runner that is already connected, so start the Mac first.
From your phone
Sign in to this console on the phone and start a Mac from Overview. Then open Amp iOS and steer the parent thread with the same sentence.
The plugin runs wherever your token is, not on the phone. That machine has to be awake and running Amp — the lid can be shut, but a sleeping laptop is not a live executor, and a thread whose executor has no token is refused as unauthorized.
Stop and save
Push the work you want to keep first. Then ask Amp “Stop the Mac”, run node cli/macorb.mjs stop, or stop it from Overview.
Stopping destroys the Mac. Files left on it do not survive, and sessions do not pause.