Requirements
- macOS 12 or newer.
- Node.js 20+ — install from nodejs.org or via Homebrew:
brew install node.
Install
- Open Terminal.
- Run the installer:
curl -fsSL https://remoteagent.online/install.sh | bash. - Follow the prompts — it places
remoteagenton your PATH.
Log in
- Run
remoteagent login. - Open the link it prints and approve the device.
- Back in the terminal, confirm you are logged in with
remoteagent status.
Start the daemon
$ remoteagent start
First message
$ remoteagent chat "what is this Mac?"
Troubleshooting
i
If permissions are off, macOS asks for Full Disk Access or Automation the first time the agent touches files or apps. Grant it, then run
remoteagent doctor to confirm.