ClawDOS Runs a Claude Coding Agent on a 4.77 MHz IBM PC XT, With TLS Handed to a Tunnel
Software / news
ClawDOS Runs a Claude Coding Agent on a 4.77 MHz IBM PC XT, With TLS Handed to a Tunnel
The GPLv3 project keeps a 176 KB harness on the 8088 and offloads encryption to a second machine, leaving a launched program 200K of the 640K.

ClawDOS, a GPL-licensed coding agent posted to Hacker News on Nov. 21, runs on an IBM PC XT with an 8088 processor at 4.77 MHz and 640K of RAM, and calls the Claude Messages API.
The project's page says the target machine is an IBM PC 5160 with a CGA card. Its author, who posts as Ricapar, wrote that "100% of this repo is written by Claude, with the exception of the text within this box." The GitHub repository showed 20 stars, 1 fork and 201 commits on main when we read it on Nov. 22.

What runs on the 8088 and what does not
The 8088 does everything except encryption. In the README's words: "The 8088 does everything but TLS." A 176 KB DOS program called HARNESS.EXE writes the API requests, parses the streamed replies, runs tools and saves each conversation to disk.
Networking uses mTCP with a packet driver over plain HTTP. A PicoMEM card supplies the disk as a microSD image and WiFi that presents itself to DOS as an NE2000 network card. A second machine runs a tunnel, either the project's tunnel/tunnel.py, socat or stunnel, and forwards the bytes to the API over HTTPS.
The tunnel can also hold the API key, so the key "never touches the PC's disk." That is a deliberate split: the old machine never sees a certificate or a secret.
| Part | Where it runs | Size or spec |
|---|---|---|
HARNESS.EXE | The PC XT | 176 KB |
CLAWDOS.EXE | The PC XT | 29 KB |
| TLS to the API | A separate tunnel machine | Not stated |
| Tools exposed to the model | The PC XT | 18 |
The memory budget
A program that ClawDOS launches gets 200K beside the harness, or 450K when the harness steps out of the way, according to the README. The machine has 640K in total, so the agent and the thing it is building compete for the same space.
- Beside the harness200 K
- Harness stepped out450 K
- Total RAM640 K
Source: ClawDOS project page, ricapar.net/ClawDOS, accessed 2026-11-22
The eighteen tools cover files, search, running DOS programs, screenshots, memory and I/O ports, PC speaker music and text art. Turbo C 2.0, two assemblers, GW-BASIC and a debugger are installed from the user's own floppy images. The page warns against redistributing an image with Turbo C on it.
Safe mode and the limits
Safe mode is on by default. Before the agent changes a file, memory or a port, the screen asks "Allow ...? (y/n)", and the F3 key turns the check off. For a related case where a sandbox flag was disabled, see our report on Docker and Codex's sandbox.
The screen is the sticking point. Replies wrap at 80 columns, and screenshots sent back to the model are 320 by 200 pixels in four colours. The README describes a WarGames tribute written on the machine, about 15 KB of Turbo C source that compiles to a WG.EXE under 10 KB.
What the README does not say
The README gives no cost figures. It requires an Anthropic API key and says prompt caching means "After a conversation's first request the PC uploads only what is new." It also says any host that speaks the Messages API works, and a /model command switches between providers listed in CLAWDOS.CFG. An example log line shows the model claude-opus-5-5.
The project reports 31 boot tests in DOSBox-X, unit tests that run on DOS and runs on 86Box. We found no independent test on real hardware beyond the author's linked video.
On Hacker News the post had 167 points and 18 top-level comments by Nov. 22. One commenter, linzhangrun, wrote that the market lacks an agent for machines running Windows XP and Windows 7. The licence is GPLv3 or later, and HARNESS.EXE links mTCP, which is also GPLv3. Another agent project that surged on GitHub, CLI-Anything, is covered separately.
Sources
More in Software
- 01Muru, Graham Dumpleton's Rust Server for Python Apps, Has 185 Open Issues and No BenchmarksThe mod_wsgi author's alpha project takes contributions as requirements rather than code, and its first post shows a 0.2 ms log line.
- 02Fast-Anything Reports a 116x Python Speedup, and 8 of Its 9 Benchmark Rows Run One JobThe MIT-licensed tool ports hot functions to Rust with a coding agent, and its README gives no run counts or variance.
- 03Levien's Next-100 Rust GUIs Post Counts About 20 New Toolkits and Bets Against egui's Immediate ModeThe Linebender author credits AI rewrites for the surge; egui's own README concedes the trade-off he is pressing on.
- 04C++26 Is Reopened: The 13–9–12 Ballot, the Enforced Label That Answers It, and What Is Still OpenSutter's Búzios report says the committee kept contracts, added one paper, and will send C++26 to a second ballot with no published date.