Choose the right build for your Mac: 68K for compact Macs, SE, Classic, II series, LC series, and Quadras. PPC for Power Macs, G3s, and later machines running Mac OS 8.1+. Download the .bin (MacBinary) file.
Both your Classic Mac and modern computer need access to the same folder. Options: a NAS or file server (AFP/SMB), a BasiliskII/SheepShaver shared directory, or any other shared filesystem. Create an AgentBridge-MyMac folder with inbox, outbox, and assets subfolders inside it.
Copy the AgentBridge application to your Classic Mac (via the shared folder or any other method). Launch it and point it at the shared folder. It will begin polling the inbox for commands.
On your modern computer, clone the GitHub repo, run npm install && npm run build, then configure Claude Desktop or Claude Code to use the MCP server. See the README for detailed configuration examples.
If your Mac has a Motorola 680x0 processor (Mac Plus, SE, Classic, II, LC, Quadra series), use the 68K build. If it has a PowerPC processor (Power Mac, G3, iMac G3, iBook), use the PPC build. The 68K build also works on PowerPC Macs, but the PPC build is optimized for those machines.
The .bin file is MacBinary format — the standard way to transfer Classic Mac files. The .dsk file is a disk image you can mount directly. Most users should download the .bin file. Disk images are available on the GitHub releases page.
No. AgentBridge is a regular application. It doesn't install extensions, modify your System Folder, or change any configuration. Launch it, quit it, delete it — your Mac is untouched.
Yes. The MCP server supports fleet configuration — point multiple Classic Macs at different shared folders and configure each as a target in fleet.json. The AI can address each Mac by name.
Yes. AgentBridge works with BasiliskII, SheepShaver, and any other emulator that supports shared folder access between the host and guest OS.
No. All communication happens through the shared folder on your local network. The AI agent connects via the MCP server on your modern computer — the Classic Mac never touches the internet.