WHAT IT IS
==========
WorkbenchAI puts a chat window on your Amiga's Workbench screen and
connects it to Claude, Anthropic's AI, over TCP/IP or the serial port.
You type a question on the Amiga; the answer comes back and is drawn in
the window -- and read aloud, if you want, by the 1978 speech
synthesiser that came with the machine.
It is a real Intuition program written for OS 1.3 in plain C: no
gadtools, no MUI, no 2.0 calls. Tested on a stock Amiga 1000 under
Kickstart 1.3, 2.0 and 3.0.
Amiga --TCP/IP---------------------------> Hub on a PC --> Claude
Amiga --serial--> WiModem232 --WiFi---> Hub on a PC --> Claude
Amiga <--------------------------------------------------- reply
NEW IN 1.2
==========
TCP/IP support, on every OS the program runs on. Set Connect to TCP/IP
in the Amiga's Settings and WorkbenchAI listens on your own TCP/IP
stack -- any bsdsocket.library stack does: AmiTCP, Miami, Roadshow, or
TheWire13 on 1.3 -- and the hub connects to the Amiga. No modem, no
baud rates, and file transfers run as fast as the machine can take
them. TCP/IP is the default on both ends; the WiModem232 and plain
serial cable work exactly as they did in 1.1.
WHAT IS IN THE ARCHIVE
======================
WorkbenchAI the Amiga program, and its icon
WorkbenchAI.readme this file
PC/WorkbenchAI-Hub.exe the other half, for a Windows PC
Both halves are needed. The Amiga cannot reach the internet or speak
HTTPS, so the PC does that part: the hub owns the modem, hosts Claude,
and passes text back and forth. Nothing is metered per token -- a Claude
subscription covers it, and there is no API key to configure.
WHAT YOU NEED
=============
On the Amiga:
Kickstart/Workbench 1.3 or newer (1.3, 2.x and 3.x all tested)
For TCP/IP: a running bsdsocket.library stack (AmiTCP, Miami,
Roadshow, TheWire13, ...) -- or for serial: a free serial port,
unit 0
Optional: LIBS:translator.library and DEVS:narrator.device for
speech. Both ship with 1.3 and 2.0; Commodore dropped them from 2.1
onward, so copy them across if you want a talking Amiga.
Optional: LIBS:xprzmodem.library to receive files
Optional: C:LhA to unpack what you receive
On the PC (Windows):
WorkbenchAI-Hub.exe from this archive
The Claude Code CLI, installed and logged in. The hub checks for it
on first run and shows you the command to install it.
An Anthropic account with a Claude subscription
Between them, one of:
TCP/IP: the Amiga's own network connection -- Ethernet, plipbox,
whatever your stack drives. WorkbenchAI listens on a port (6400 by
default) and the hub connects to the Amiga. This is the default on
both ends.
A WiModem232 on the Amiga's serial port, talking to the PC over your
network.
A null-modem or USB-serial cable straight from the Amiga's serial
port to the PC.
For the serial choices the Amiga's rate must match: WorkbenchAI takes it
from Workbench Preferences, and the hub is told the same number in
Settings. There is no autobaud. TCP/IP has no rate to match.
GETTING STARTED
===============
1. Copy WorkbenchAI to your Amiga -- floppy, CF card, whatever you
normally use. This first copy cannot come over the wire: the program
has to be running before it can receive anything.
2. On the PC, run WorkbenchAI-Hub.exe. It will tell you what is missing
and how to fix it, then ask for your Amiga's IP address.
3. TCP/IP: start your stack, then double-click WorkbenchAI -- it
listens on port 6400 out of the box. Serial instead: pick it under
Connect in Settings, and set the Amiga's serial rate in Preferences
to match your modem.
4. Type something and press Return.
The window opens empty. That is deliberate: anything it says on startup
is something that needs your attention.
WHAT IT CAN DO
==============
Ask it about the machine it is running on and it asks the Amiga, rather
than guessing: free space on every volume, the Kickstart and library
versions, how much chip and fast RAM there is, the screen mode. It can
set the Amiga's clock, which an A1000 needs at every boot. It can open
the Clock or a Shell window on your Workbench screen. It can search the
web, and it can fetch a file -- from Aminet, say -- and send it down the
wire with ZMODEM, then offer to unpack it for you.
Speech is off by default; turn it on in Settings (right-Amiga E), where
the voice, rate and pitch live too. It reads numbers, dates, times and
filenames the way a person would say them, which took more work than
you might think.
THANKS AND CONTACT
==================
Bug reports are welcome at the address above. If it Gurus, the number
helps -- and so does what you were doing at the time.
LICENCE
=======
Freeware. Copyright (C) 2026 Haakon Kjole.
Free of charge, for any use. You may pass it on -- on Aminet, on a cover
disk, in a collection -- as long as the archive stays complete and
unmodified and nobody is charged for the program itself. Anything beyond
that, just ask.
No warranty of any kind. It talks to your serial port, writes files
where you tell it to, and can set your clock. It has been tested on real
hardware under 1.3, 2.0 and 3.0, but you run it at your own risk.
|
aminet net>