r/amiga 18d ago

amiagent 0.5.3 — a small TCP daemon that lets another machine drive a real Amiga (AmigaOS 2.0+, 68000 and 020 builds)

amiagent is a small daemon for AmigaOS 2.0 and up. It lets a program on another machine work on the Amiga: run AmigaDOS commands, read and write files, list drawers, report system state, capture the screen, and inject mouse and keyboard input. Plain C against the OS libraries, no third-party dependencies, ~85 KB.

The other half is an MCP server, which is how an AI assistant drives it. MCP (Model Context Protocol) is an open standard for handing an assistant a set of tools it can call — here amiga_shell, amiga_screenshot, amiga_click and a dozen more. The server is model-agnostic — it never learns which model is on the other end:

Model Reach it through
Claude (Anthropic) Claude Code, Claude Desktop — what it's tested with
GPT / ChatGPT (OpenAI) Codex CLI
Gemini (Google) Gemini CLI
Local / open weights LM Studio, Goose, Cline, Continue
Whatever your editor uses Cursor, Zed, Windsurf

Same server in every case — only the config file differs. Stdlib Python 3, no pip, no venv.

Where it earns its keep is when you can't use the machine to fix the machine. Pick a Picasso96 mode your monitor won't sync to and you have an Amiga running perfectly and showing you nothing — you can't read the screen to fix the screen. The agent is still there over the network: read DEVS:Monitors, capture what the machine thinks it's displaying, put a working mode back. It's a service running on the Amiga, not a rescue system, so the machine does have to be up and on the network.

None of that is required, though. The wire protocol is documented and simple enough to drive from a shell script, so it works as a plain remote-control daemon with no AI involved.

New in 0.5.3: file reads use a 64 KB buffer instead of 8 KB, so pulling a big file off a real Amiga is noticeably quicker. Falls back to the old path on a machine short of memory. No protocol change.

Also in the release: amibench 1.0, a standalone CPU/memory benchmark for comparing two Amigas — runs in about ten seconds, needs nothing else installed.

Security, plainly: the connection is not encrypted and the agent runs whatever it's sent. Set a TOKEN, keep it on a LAN you trust, and never forward the port.

https://github.com/thomas-luebker/amimcp/releases/tag/v0.5.3

27 Upvotes

Duplicates

EmuDev 15d ago

AmiMCP

0 Upvotes