AmigaTools by Elyan Labs

Modern software for the classic Commodore Amiga. Native Motorola 68k (m68k) apps for AmigaOS 3.x and AROS: a web (Gemini) browser, Mastodon and Nostr clients, an MCP server, a Claude AI client, the Lua language, the Amiga's own speech voice, and of course the Boing Ball. No emul-only tricks and no Node.js. Real C, cross-compiled to real AmigaOS executables, tested inside FS-UAE and on real Workbench 3.1.

If you have an Amiga 500, 1200, 4000, a Vampire, a MiSTer core, or just FS-UAE, these run on it.

The tools

Tool	What it does
`gemini/`	A Gemini protocol (`gemini://`) browser. TLS via AmiSSL, a `text/gemini` renderer with a numbered link index, redirects, and an interactive browse loop. The web the Amiga can actually run.
`mastodon/`	A Mastodon / Fediverse client. Read your timeline and post a toot over HTTPS. Your token stays on the Amiga (in `SYS:.mastodon/token`).
`nostr/`	A Nostr client. Reads notes from a relay over a TLS WebSocket (RFC6455 handshake and framing, NIP-01). Publishing is a marked TODO (secp256k1 Schnorr).
`mcp/`	A Model Context Protocol server that runs ON the Amiga, exposing read_file / write_file / run_command as MCP tools over stdio JSON-RPC. A modern AI agent can drive the Amiga.
`claude/`	A native Anthropic Claude client with a real tool-use loop. Chats, and reads/writes files and runs AmigaDOS commands at Claude's instruction, behind a confirm gate.
`lua/`	Lua 5.4.7 ported to m68k (`lua`, `luac`), configured for the toolchain.
`narrator/`	A `say` command that speaks text through the Amiga's built-in narrator.device, the iconic robotic voice, from C.
`boing/`	The Boing Ball as native m68k code. Because obviously.
`common/`	Shared code every tool reuses: the AmiSSL and bsdsocket transport, dependency-free JSON helpers, and the dev guide.

Each tool has its own README with build and usage, a Makefile that cross-compiles with one Docker image, host-tests for its pure logic, and a committed AmigaOS binary you can grab without a toolchain.

In-emulator test status (honest)

Every tool is cross-compiled to a verified AmigaOS hunk and host-tested. Beyond that, here is exactly what has been run inside a booted Amiga (FS-UAE), with the evidence in each tool's test/:

Tool	In-guest status
claude	Verified. Haiku scaffolded, compiled (vbcc), and ran a C program on real Workbench 3.1.
gemini	Verified. Fetched a capsule through the proxy and rendered gemtext on AROS.
nostr	Read path verified. Write path: event serialization and sha256 id computed and host-testable (signature not implemented).
mcp	Verified. `write_file` and `read_file` acted on the Amiga; `run_command` works with a mounted `T:`.
lua	Runs on real Workbench 3.1 (prints correct output). Fails on the bare AROS ROM, which lacks the mathieee libraries.
boing	Renders on AROS.
narrator	Loads and runs, but fails gracefully because neither AROS nor Commodore Workbench ships `translator.library`. Needs a ROM/setup that has it.
mastodon	Verified. Fetched a timeline through the proxy and rendered three toots (one a boost) on AROS; the post command returns cleanly.

Build

One image cross-compiles everything: amigadev/crosstools:m68k-amigaos.

hljs language-bash

cd gemini && make          # cross-compile to bin/gemini
cd gemini && make host-test # run the host self-tests

make test from the repo root runs every app's fast host-side self-test in one shot (see tests/README.md for what that does and does not cover).

See docs/AMIGA_APP_DEV_GUIDE.md to add your own tool. It has the m68k traps that will otherwise cost you hours (use -m68020, no libnix __stack global, fflush stdout, open bsdsocket v3, AmigaDOS is not bash) and the reusable transport and JSON code.

Honest scope

Not the first at everything. AmigaGPT already does Claude chat on the Amiga; what is new here is the agentic tool-use loop on 68k. We state prior art per tool in each README and do not claim false firsts.
The TLS tools ship two transports: AmiSSL direct HTTPS from the Amiga, and a small host proxy for machines with no TLS library (which also keeps API keys off the Amiga). In-emulator tests use the proxy path.

RustChain Amiga Edition - the Proof-of-Antiquity blockchain miner and SDK for 68k AmigaOS, where these tools started before moving here.
Elyan Labs - the lab.
RustChain - the chain, and the BCOS program.

License

MIT (see LICENSE). Meets Elyan Labs' Beacon Certified Open Source (BCOS) L1 tier (85/100), cert BCOS-5664a2af, anchored on the RustChain ledger and publicly verifiable at https://rustchain.org/bcos/verify/BCOS-5664a2af. See BCOS.md for the precise scope of that claim.

AmigaTools by Elyan Labs

If you have an Amiga 500, 1200, 4000, a Vampire, a MiSTer core, or just FS-UAE, these run on it.

The tools

Tool	What it does
`gemini/`	A Gemini protocol (`gemini://`) browser. TLS via AmiSSL, a `text/gemini` renderer with a numbered link index, redirects, and an interactive browse loop. The web the Amiga can actually run.
`mastodon/`	A Mastodon / Fediverse client. Read your timeline and post a toot over HTTPS. Your token stays on the Amiga (in `SYS:.mastodon/token`).
`nostr/`	A Nostr client. Reads notes from a relay over a TLS WebSocket (RFC6455 handshake and framing, NIP-01). Publishing is a marked TODO (secp256k1 Schnorr).
`mcp/`	A Model Context Protocol server that runs ON the Amiga, exposing read_file / write_file / run_command as MCP tools over stdio JSON-RPC. A modern AI agent can drive the Amiga.
`claude/`	A native Anthropic Claude client with a real tool-use loop. Chats, and reads/writes files and runs AmigaDOS commands at Claude's instruction, behind a confirm gate.
`lua/`	Lua 5.4.7 ported to m68k (`lua`, `luac`), configured for the toolchain.
`narrator/`	A `say` command that speaks text through the Amiga's built-in narrator.device, the iconic robotic voice, from C.
`boing/`	The Boing Ball as native m68k code. Because obviously.
`common/`	Shared code every tool reuses: the AmiSSL and bsdsocket transport, dependency-free JSON helpers, and the dev guide.

In-emulator test status (honest)

Every tool is cross-compiled to a verified AmigaOS hunk and host-tested. Beyond that, here is exactly what has been run inside a booted Amiga (FS-UAE), with the evidence in each tool's test/:

Tool	In-guest status
claude	Verified. Haiku scaffolded, compiled (vbcc), and ran a C program on real Workbench 3.1.
gemini	Verified. Fetched a capsule through the proxy and rendered gemtext on AROS.
nostr	Read path verified. Write path: event serialization and sha256 id computed and host-testable (signature not implemented).
mcp	Verified. `write_file` and `read_file` acted on the Amiga; `run_command` works with a mounted `T:`.
lua	Runs on real Workbench 3.1 (prints correct output). Fails on the bare AROS ROM, which lacks the mathieee libraries.
boing	Renders on AROS.
narrator	Loads and runs, but fails gracefully because neither AROS nor Commodore Workbench ships `translator.library`. Needs a ROM/setup that has it.
mastodon	Verified. Fetched a timeline through the proxy and rendered three toots (one a boost) on AROS; the post command returns cleanly.

Build

One image cross-compiles everything: amigadev/crosstools:m68k-amigaos.

hljs language-bash

cd gemini && make          # cross-compile to bin/gemini
cd gemini && make host-test # run the host self-tests

make test from the repo root runs every app's fast host-side self-test in one shot (see tests/README.md for what that does and does not cover).

Honest scope

Not the first at everything. AmigaGPT already does Claude chat on the Amiga; what is new here is the agentic tool-use loop on 68k. We state prior art per tool in each README and do not claim false firsts.
The TLS tools ship two transports: AmiSSL direct HTTPS from the Amiga, and a small host proxy for machines with no TLS library (which also keeps API keys off the Amiga). In-emulator tests use the proxy path.

RustChain Amiga Edition - the Proof-of-Antiquity blockchain miner and SDK for 68k AmigaOS, where these tools started before moving here.
Elyan Labs - the lab.
RustChain - the chain, and the BCOS program.

amigatools

AmigaTools by Elyan Labs

The tools

In-emulator test status (honest)

Build

Honest scope

Related

License

Similar Packages

amigatools

AmigaTools by Elyan Labs

The tools

In-emulator test status (honest)

Build

Honest scope

Related

License

Similar Packages