Skip to main content
Glama
arek-mcp
by smikes75

amiga-re-kit (AREK)

Old Amiga games, rebuilt to run in your browser. AREK (Amiga Reverse Engineering Kit) is a free toolkit that lets an AI coding agent take a 1990s Amiga game apart, piece by piece, and build it again as a modern program: the game's own 68000 code from the disk is translated ahead of time to C and WebAssembly, the chipset is a model checked against the vAmiga emulator, and every step is measured against the original. The rebuilt game plays like the original, moves smoothly on today's screens and can show more of the level than the old window did.

Alien Breed II in the rebuild: the original window next to the wider view

Website: https://smikes75.github.io/amiga-re-kit/ (videos, the playable demo, About, FAQ; Czech mirror). Feedback: GitHub Discussions.

Status, November 2026

  • Alien Breed II (Team17, 1993): the whole game playable at https://arek.fun/alienbreed2/ with your own disk images (A500 version, disks 1 and 2 as .adf; the preserved Fairlight dumps are verified, an original retail disk is not yet; AGA is not supported). Original and Enhanced modes, one or two players; levels 1–2 measured against the original, the later levels are being checked.

  • Superfrog (Team17, 1993): the whole game playable at https://arek.fun/superfrog/ with your own four disks; Magic Woods 1–2 verified against the original with a recorded run.

  • The kit: version 1.0.79 on PyPI, 2819 tests. Extracted from five game rebuilds (S.W.I.V., Turrican II, Superfrog, Alien Breed, Alien Breed II) and made game-agnostic: one Python package (arek), one command line (arek), and an MCP server (arek-mcp) so an AI assistant can drive the same instruments you do.

The method is the point: first a complete, measured description of the original, only then anything else. Nothing here guesses. The decoder refuses instructions it does not model, the walker reports every indirect jump it cannot follow, the packers verify with the checksums the originals carry, and the emulator captures are compared byte for byte.

No game data is included or needed to run the kit. The tests use hand-assembled programs and random buffers. Your disk image and Kickstart ROM stay on your machine, referenced from a git-ignored local.conf.

Related MCP server: Antardrishti

Install

pip install "amiga-re-kit[mcp,web]"  # from PyPI; or from a checkout: pip install -e ".[mcp,dev]"
python -m pytest                    # 2819 tests: synthetic data + CPU timings measured on Moira
arek --help

Optional: a patched headless vAmiga for anything that runs the original (arek shot, arek bpstate) — see docs/HEADLESS.md. Optional: m68k-elf-objdump for arek xref.

The workflow in commands

arek init myproject && cd myproject    # skeleton + local.conf (edit the paths)

# 1. measure the disk
arek adf info  disk.adf                # size, sha256, boot block, checksum
arek adf map   disk.adf                # entropy picture, one char per sector
arek adf regions disk.adf              # where code / data / packed blocks sit
arek scan      disk.adf                # packer signatures, verified Bytekiller blocks (formats B and BK)

# 2. unpack what the loader unpacks
arek adf track  disk.adf -n 1 -o trk1.bin
arek adf ls     disk.adf                              # AmigaDOS files, if the disk has a filesystem
arek adf cat    disk.adf -p LEVELS/L1 -o l1.atn       # one file, data blocks verified
arek adf build  out.adf --payload image.bin --load 0x1000 --entry 0x1100   # a bootable disk that loads one memory image and jumps to it
arek pp20       file.pp -o file.bin    # PowerPacker 2.0
arek bytekiller trk1.bin --offset 0x200 -o main.bin
arek t2         INTR -o intr.bin       # Turrican II three-stage
arek atn        BLOCK -o out.bin --offset 0x1234   # Atomik (ATN!), block inside an image
arek rnc        disk.adf -o out.bin --offset 0xd5a32   # Rob Northen Compression method 1 (ProPack), both CRCs verified
arek hunk info  prog && arek hunk load prog --base 0x20000 -o h   # AmigaDOS executables
arek hunk split prog --chip prog2 --base 0xc00000 0x20000 -o h    # records split over two files

# 3. read the code - flow graph, not linear
arek dis    main.bin --base 0x20700 --walk 0x20700     # only reachable code
arek walk   main.bin --base 0x20700 --start 0x20700    # call tree + frontiers
arek walk   main.bin --base 0x20700 --start 0x20700 --inline 21800:until=8000  # data stored after bsr
arek hwscan main.bin --base 0x20700 --roots 0x20700    # the hardware boundary
arek copper ram.bin --base 0x0 --limit 200             # a copper list from a RAM dump
arek bpstate --address 0x21234 --end 20 --out cap/f --screenshot   # RAM, chip registers and the picture
arek render  cap/f                                     # the frame RAM shows, compared with the picture
arek xref   prog.txt --syms syms.json                  # from an objdump listing
arek dis    main.bin --base 0x20700 --dcw              # linear, undecodable words as dc.w
arek dis    main.bin --base 0x20700 --walk 0x21234 --cycles   # 68000 clock count per instruction

# 4. translate and verify
arek recomp  main.bin --base 0x20700 --auto 0x21234 --main -o draw.c
arek recomp  main.bin --base 0x20700 --auto 0x20700 --refusals ref.json -o game.c   # every frontier as JSON
arek recomp  main.bin --base 0x20700 --auto 0x20700 --overlay 41d5c:b000 --dynamic 21350 -o game.c
arek recomp  intro.bin --base 0x41d5c --auto 0x41d5c --lib --prefix in_:41d5c:4cd5c --overlay-module 41d5c -o intro.c
arek recomp  main.bin --base 0x20700 --auto 0x20700 --timing --profile --main -o game.c   # then AREK_PROFILE=p.txt ./game ...
arek profile p.txt --by clocks                         # which routines to rewrite or replace (--extern) first
arek recomp  main.bin --base c00000 --auto c00000 --cover --oob zero --out game.c   # coverage bitmap; reads outside RAM give 0
arek cover   run1.cov run2.cov game.c.cover.json       # what the runs never executed (union of seeds; routines least covered first)
arek fuzz    --seed 3 --frames 30000 --start 320 --out build/in3.txt   # random input: the emulator (--inputs) and the rebuild alike
arek recomp  main.bin --base 0x20700 --auto 0x21234 --timing \
             --jtab 21300:21400:12:4:bra --indirect 21350=21500,21600 --extern 21700=load_file -o game.c
arek bpstate --address 0x21234 --end 20 --out cap/before
arek bpstate --address 0x21300 --end 20 --out cap/after
arek diff    cap/before cap/after --range 0x60000 0x70000
arek shot    build/shots/title 5 10 --at 3 "joystick2 press 1"
arek trace   run build/l1.vtr --arm 196 --end 199 --break 0xc01106 --range 0:80000 c00000:80000
arek trace   show build/l1.vtr --field px=0xc0599e:h  # one row per hit, emulation never stopped
arek trace   run build/l1.vtr --arm 3 --end 60 --break 0xc01106 --inputs l1.txt --reglog regs.bin  # input per frame
arek trace   compare build/orig.vtr build/native.vtr --best-shift 3   # long parity: where the rebuild leaves the original
arek trace   bus build/bus.bin --frame 8600            # who had the chip bus in every slot (buslog patch)
arek trace   run build/s.vtr --arm 3 --end 176 --shots build/f --shot-frames 8600:8619   # 20 frames, one run
arek trace   run build/w.vtr --arm 3 --end 200 --break 0xc01b06 --poke c01b06:c00faa=00000002  # write into the machine, go on
arek selftest inputs                                   # is this VAHeadless frame exact? (synthetic disk; 1.0.25: the mouse too - m<dx>:<dy>, B / C)
arek selftest mouse                                    # RetroShell `mouse1 move dx=5 dy=-3` moves the JOY0DAT counters (vamiga-mouse-899da5d.patch)

# 4b. many scenarios at once (arek.parity.suite): state (traces), picture (--shots), sound (--reglog)
# 5. the web page: display contract wb-shell obraz 1.4 (WB-OBRAZ-CRT.md)
arek web copy web/                                     # the reference wb-obraz.js into the game's page (1.5: WebGL2 or 2D presenter, one API)
arek web demo                                          # a page built on it (http://127.0.0.1:8920/demo.html)
arek web test http://localhost:8911/?test=1            # §5.1-5.4b in Chromium on both presenter paths (?gl=0 / ?gl=1) and §5.7 their equality (needs playwright)
arek web seal build/present/engine.wasm --set disk1.adf --label "disk 1, retail" --gzip --out build/present/sealed
arek web seal build/present/engine.wasm --payload build/payload.bin --payload-label "the game files" --out build/present/sealed  # any disk version with the same game data opens it
arek web check build/present                           # a bundle: no game data, derived files sealed, manifest right
arek parity  suite.json                                # scenarios against the original: state, picture, sound per tick
#    1.0.41: the page's life - a lost WebGL context comes back (wb-obraz 1.9, wb-scene 2.11), keys never stay down behind the
#    page's back and WBTAKT.lifecycle tells hide / show (wb-takt 1.5), wb.css no longer resizes the canvas; `arek web copy`
#    writes wb-kit.json and `--check` says whether a game's modules are current, stale or edited; CHANGELOG.md
#    1.0.40: found by the same audit - a callee that removes its own arguments no longer ends its caller (CALL_END goes by
#    the address the rts popped), movem (An)+ with An in the list, CIA timer interrupts when the timer runs out, no bitplane
#    DMA = no fetch and no sprites (selftest display), VHPOSR past the frame end; difftest with directed encodings
#    1.0.39: equal means covered - a rebuild that ends early, a side that is missing, bytes it did not capture or frames
#    without a picture are differences (PROBLEM lines, exit 1; --fail: any difference is exit 1); docs/HEADLESS.md
arek web copy web/                                     # also wb-nastaveni.js (the shared Display / Sound menu; never overwrites a file that is not from the kit), wb-zvuk.js (sound contract 1.1), wb-atn.js + wb-content.js (the game's files from the visitor's disks)
arek web payload --atn ADF1:0x57800 ADF2:0x64a00 --out build/payload.bin --content web/content.json   # the payload for --payload and the hashes the page matches
arek web serve build/present --port 8930               # the bundle with the disks of local.conf at /local-disks/diskN.adf (localhost)
arek web serve build/present --isolated                 # ... with the COOP / COEP headers (an engine with shared memory)
arek web strip web/page.js build/present/page.js --drop FULL   # the presentation's variant: lines //@FULL and blocks //@FULL{ ... //@}FULL cut out
arek web longrun http://127.0.0.1:8930/ --minutes 3     # smoothness over a longer play (playwright; the page's globalThis.WBLONGRUN hook)
#    arek web test 1.5.2 §5.5: the game canvas must lie under the presenter's .crt-layer (a scene canvas appended after it hid the CRT - Superfrog); the Screen moves the layer and warns
arek web smooth http://127.0.0.1:8920/smooth-demo.html  # the canon's limits in Chromium and WebKit: dropped frames, camera and object steps, missing passes, key latency, sound under stalls (docs/WB-PLYNULOST.md; --no-interp for an original mode)
#    wb-scene.js (0.9.0): the wider, smoother view composed on the GPU from one record per game frame (clean window, map, objects, sprites, HUD),
#    with a CPU reference for a 0-mismatch check; scene-demo.html shows it (docs/WB-PLYNULOST.md G); 1.5: subpixel - the playfield
#    moved by fractions of a device pixel (even motion on a 60 / 144 Hz display); 1.6: the objects go with the ground unless
#    objects[].steady (a tracked player), unexplained() - the window's pixels the model does not explain, for window.over;
#    1.7: extrapolateObjects (the objects past the last pass, a fixed objects' latency), the HUD cached; wb-takt 1.3 fixed latencies;
#    1.8: the GPU equal to the reference at any scale (whole-number sampling since 2.0.1); arek web smooth reports key -> player when
#    the page gives player(); 2.0 (kit 1.0): the contract frozen - docs/WB-RECIPE.md is the one page a game writes from; 2.1 (kit 1.0.2):
#    the 0.9.15 transition and 0.9.16 freshSprites removed - counterproductive in every game (G60), the presenter's transition stays;
#    wb-obraz 1.7 (kit 1.0.3): present({source | pixels + size, rect, smooth}) - a source of any size into a rectangle of the content (a hires title, an interlude)
#    wb-obraz 1.8 (kit 1.0.32): new Screen(game, canvas, {crtEnhanced: 'original'}) - Enhanced that only smooths the motion keeps the Original CRT
arek web replay http://127.0.0.1:8920/scene-demo.html --hz 50,60,120,144 --frames 300 --route 1:120,2:60,0:120
#    the display never touches the game: the page under a virtual clock at four rates, the same inputs by game frame, one state fingerprint (H)
arek docs WB-PLYNULOST                                   # the kit's documents ship with it (arek docs: the list; --path: the file)
arek shots cap/shots/o build/shots/h --align 8          # the pictures of two runs paired by frame, each pair aligned for a screen shake
arek web test http://localhost:8911/?test=1            # ... and §6: the menu and the sound contract, when the page has the hooks

# 6. time inside the frame: the bus model per DMA slot (docs/BUS.md)
arek bus     copy lib/                                 # the model's C sources into a rebuild (arek_bus_glue.h behind the translation's hooks)
arek recomp  main.bin --base c00000 --auto c00000 --timing --bus-table --out game.c   # bus table: words, extra accesses, flags and the bus pattern per instruction
arek roots   main.bin --base c00000 --lo c00fa0 --hi c58a8c --json roots.json        # static roots of a whole game (slot tables, pointer tables, stored handlers)
arek recomp  main.bin --base c00000 --auto-file roots.txt --resume --out game.c       # 1.0.26: tasks with their own stacks (rte / rts into another task)
arek difftest --moira ~/src/vamiga                    # 1.0.26: every opcode through the translation and through Moira, vAmiga's 68000
arek difftest --corpus cases.txt.gz                   # the same against recorded results: a C compiler is enough
arek difftest --moira ~/src/vamiga --bus-patterns buspat.json   # 1.0.55: every instruction's bus cycles and interrupt sample point, measured on Moira
arek recomp  main.bin --base c00000 --auto-file roots.txt --auto-soft --out game.c    # a root into data is dropped, not refused
arek selftest bus                                      # the model against this VAHeadless's bus log (synthetic program, BLTPRI blits)
arek selftest audio                                    # the Paula model (audio DMA slots, output bytes) against this VAHeadless's logs
arek host copy lib && arek host state cap/s0 state0   # the host of a translation (docs/HOST.md) and the state a run starts from
arek host pack state0 state0.bin && arek host engine web/eng --game game.c --l3 f_c13e1c --entry f_c01c72 --run   # the web engine (ASYNCIFY)
arek host engine web/eng --game game.c --l3 f_c13e1c --entry f_c01c72 --thread --run   # ... in its own thread over shared memory (no ASYNCIFY; the page needs COOP/COEP)
arek --version                                         # version + decoder/recompiler hashes

Every command prints what it measured and nothing else. arek audit profile.json produces the JSON inventory + reachability record the method asks for (see examples/profile.example.json).

What is inside

module

what it does

origin

arek.adf

geometry, boot block checksum, entropy map / regions, inventory

new

arek.amigados

AmigaDOS OFS/FFS reader (directories, files, extension blocks, checksums) + synthetic image builder for tests

new

arek.packers.pp20

PowerPacker 2.0 decruncher (+ literal-only encoder for tests)

Turrican II / Superfrog

arek.packers.rnc

Rob Northen Compression method 1 (ProPack: Huffman tables per chunk, raw bytes in the stream, the reader's prefetch discipline), both CRCs verified; a naive packer for the round-trip tests

Xenon 2

arek.packers.bytekiller

Bytekiller format B (8-byte header, XOR checksum), BK (the classic 12-byte header; kit 1.0.4) and the SWIV word-stream format A

S.W.I.V., Turrican II

arek.packers.turrican2

Huffman → backwards LZ → RLE three-stage decruncher

Turrican II

arek.packers.atomik

Atomik (ATN!) decruncher with exact block extent (+ greedy LZ test encoder)

Superfrog

arek.packers.scan

brute-force scan: signatures (PP20, RNC, ATN!, IMP!, …) + verified blocks

S.W.I.V.

arek.hunk

bounded HUNK reader: CODE/DATA/BSS, RELOC32, split streams; build() for probes

Superfrog

arek.copper

copper list disassembler with custom register names

S.W.I.V.

arek.webtest, web/wb-obraz.js

display contract 1.5: reference module (whole device pixels, CRT canvas, layout quantum of Chromium's 1/64 px, the pixel aspect, a presenter that owns the visible canvas on WebGL2 or 2D with one API - one canvas, no copy between contexts, §3 in the shader), demo page, Chromium tests incl. the row test on both paths and their pixel equality

Turrican II, Alien Breed, Superfrog (Sonnet), Alien Breed II

arek.m68k.cover, arek.fuzz

coverage of a translation run (recomp --cover: one bit per translated instruction, arek cover lists what never ran) and deterministic random joystick input (arek fuzz, one file for trace run --inputs and the rebuild) - where a long random run stalls, a bug hides

Superfrog

arek.bus (src/arek/bus/*.c)

the Amiga bus per DMA slot: who owns each slot, the blitter cycle by cycle, the CPU by the accesses of its instructions - on which instruction an interrupt lands, when a blit ends, whether the original overran the frame; arek_bus_vamiga.c is MPL-2.0 (derived from vAmiga)

Alien Breed

arek.m68k.timing.bus

bus cycles n(r/w) of every instruction, opcode and extension words included - what a model of the Amiga bus per DMA slot needs beyond the clock count

Alien Breed

arek.m68k.difftest (arek difftest)

the translation against Moira, the 68000 of vAmiga, opcode by opcode: registers, flags, memory, where it ended and the clock count; a recorded corpus replays without Moira (1.0.26)

all of them

arek.kb (arek kb, MCP kb_search / kb_get / kb_add)

the knowledge base of the rebuilds: records of what was measured and learned (symptom, cause, check, resolution, evidence), searched by the words of the log an agent sees; the base is a folder of the user's (AREK_KB), the kit only reads, searches and proposes

all the rebuilds

docs/REBUILD-PLAYBOOK.md, host/arek_host_engine_node.js

the method of the whole-game rebuilds (milestones, the start from the disks without a Kickstart, module discovery, the page's events at exact frames, the scene record, the public build checklist) and the Node harness that drives the wasm engine for a project's measurements

Alien Breed II, Superfrog, Turrican II

host/ (arek host copy)

the host of a translation: time from the bus model, the beam, interrupts 1-6, CIA-A with the E clock, Paula, the picture line by line in C (arek_display.h, 0 px against the emulator), the trace driver (arek_host_trace.c), arek host state from a capture, disk images at run time (arek_host_disk.h), a data disk the game writes (arek_host_datadisk.h), the web engine (arek_host_engine.c, Emscripten ASYNCIFY, arek host engine, held against its native build by arek_host_engine_check.js) (docs/HOST.md)

Alien Breed II

bus/arek_bus_paula.h

Paula's audio DMA for the bus model: the channels' slots and output bytes, exact against the emulator (arek selftest audio)

Alien Breed II

web/wb-nastaveni.js, web/wb-zvuk.js

the shared Display / Sound menu of the rebuilds (same ids, ranges, defaults per mode, storage, optional zoom snapping to the whole-device-pixel zooms; the game adds its items and texts) and the sound contract 1.1: one stereo-width rule, 20 ms gain ramps, the Amiga 500's filters from the schematic in prescribed digital forms, test hooks for arek web test §6

Alien Breed, Superfrog

web/wb-menu.js, web/wb.css

the Workbench 1.3 bar of a rebuild's page (Project / Display / Game / Sound / ?): an open menu or requester suspends the game, Esc and the arrow keys, a notice line; the markup is the page's (docs/WB-RECIPE.md)

Alien Breed II, Superfrog

web/wb-takt.js

the clock of a page (canon C): the game's frames allowed by the display's clock, the lock on a k x 50 Hz display, the timeline of the frames, the picture behind the game with pairs for the interpolation and extrapolation, keys at the event; the synthetic page smooth-demo.html runs on it

Alien Breed II, Superfrog (Sonnet)

web/wb-zvuk-worklet.js, web/wb-zvuk-out.js

Paula's output into Web Audio (canon D): an AudioWorklet over a ring of stereo int16 - the engine's ring in shared memory with written / read counters (a stalled main thread does not interrupt the sound, the engine computes on when the reserve runs low) or the game's frames by messages; the reserve, dropouts and output latency for the hooks

Alien Breed II, Superfrog (Sonnet)

web/wb-touch.js

touch controls for a page: a virtual stick and buttons (fire, the page's keys), shown on touch devices or with ?touch; WBTOUCH.bits() as the keyboard's bits, its own styles

Alien Breed II

host/arek_host_datadisk.h, web/wb-datadisk.js

the data disk a game writes (Team17's "insert your custom datadisk" for the high-score table): sectors in the host behind the game's disk routine (--extern, the project's registers; in the drive for good or only around the game's prompt), kept in the browser's localStorage by the page - loaded before the game runs, saved after every write, cleared on a second click; a file natively

Alien Breed II, Superfrog (Sonnet)

web/wb-atn.js, web/wb-content.js, arek web payload

the ATN! decruncher for a page (a port of the kit's, 0 differences against the games' own) and the content key: the page unpacks every ATN! block of the visitor's disks, keeps the files whose size and SHA-256 content.json lists, joins them in order - the payload of arek web seal --payload, so any disk version with the same files opens the sealed code

Alien Breed II

arek.seal, web/wb-seal.js

code derived from a game on a public page, encrypted (AES-GCM) under a key computed from the contents of the original disk, or from the game's own content as the page's loader rebuilds it (a payload key: every disk version with the same game files opens it); opened in the browser with WebCrypto

presentation pages

arek.parity

long parity: record by record against the original's trace (first difference, addresses, phase shift); traces packed as XOR + zlib

Alien Breed, Turrican II, Superfrog (Sonnet)

arek.display

the frame chip RAM shows: Copper timing, bitplanes, dual playfield, EHB, sprites; vAmiga's colours; 0 differing pixels on vAmiga screenshots (arek selftest display)

Superfrog (Sonnet), Alien Breed, Turrican II

arek.m68k.decoder

strict 68000 decoder: raises Unsupported instead of guessing; accepts only addressing modes the 68000 accepts (checked opcode by opcode against Moira)

Superfrog (fixed ADDA/SUBA/CMPA); LINK/UNLK/PEA/EXG from Alien Breed; memory shifts, CMPM, ABCD/SBCD, MULS/DIVS new

arek.m68k.disasm

linear and flow-walk listings straight from the decoder

new

arek.m68k.hwscan

which routines are pure RAM and which touch custom chips / CIA / ROM

Turrican II

arek.m68k.recomp

static 68k → C recompiler with a verification driver (MEM[], write log, blitter incl. line and fill modes); jump tables (also with a base register known only at run time), indirect targets, external routines, overlay modules recognised at run time by fingerprint, run-time targets (--dynamic), data stored after a call (Flow); optional clock counting; a WAIT_LOOP(m, pc, addr) hook in loops that poll memory or hardware; chip RAM size and slow RAM (--memsz, --slow c00000:80000); a routine profile (--profile: calls, clocks, written pages per routine - the map for rewriting a recompiled game routine by routine)

Superfrog; extensions from Alien Breed

arek.m68k.timing

68000 clock counts per instruction, data-dependent ones included (MUL/DIV operands, shift counts, branch outcome); matches Moira on all 42 247 decodable opcodes

new

arek.m68k.xref

call / data cross references from m68k-elf-objdump text

Superfrog

arek.m68k.audit

profile-driven inventory + conservative reachability, JSON in / JSON out

Superfrog

arek.headless

local.conf, RetroShell scripts, screenshots, breakpoint captures

Turrican II / Superfrog

arek.headless.trace

continuous trace reader/driver: VTR1 (chip RAM), VTR2 (chosen ranges), VTW2 (watchpoint + PC)

Turrican II / Alien Breed

arek.contract

byte-level comparison of captures, register diffs, "untouched" assertions

Superfrog

arek.cli / arek.mcp_server

the command line and the MCP server

new

Each module's docstring explains the format or the measurement it implements; docs/METHOD.md explains how they fit together.

MCP: let an assistant hold the instruments

pip install -e ".[mcp]"

Claude Code (.mcp.json in your project, or claude mcp add arek -- arek-mcp):

{"mcpServers": {"arek": {"command": "arek-mcp"}}}

The server exposes 29 tools (kit_info, kb_search, kb_get, kb_add, adf_info, adf_map, adf_ls, adf_file, scan_packed, unpack, hunk_load, disassemble, walk, hwscan, recomp, xref, copper, headless_shot, headless_bpstate, trace_records, diff_captures, ram_at, …). kit_info returns the version and the SHA-256 of the decoder and recompiler; record it with every measurement. All of them take paths on the local machine; the server never fetches anything, never writes outside the paths it is given, and only returns measurements — the assistant sees entropy maps, listings and diffs, not your disk image.

A working session looks like: "map the disk" → "scan for packed blocks" → "unpack the block at 0x1f40 and walk it from its entry" → "which of these routines touch hardware?" → "recompile 0x21234 and compare its RAM writes with a capture of the original". Every answer is backed by a tool result.

The kit is MIT (see LICENSE). It ships no game data, no ROM, and no game-specific knowledge — the "engine without data" model: you supply the image you own. The vAmiga patches are modifications of MPL-2.0 sources and are published as required; see THIRD-PARTY.md.

Code comments inside the transplanted modules are partly in Czech (the projects' working language); public docstrings, the CLI and the docs are English.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Exposes read-only local analysis tools for source auditing, web traffic review, binary reverse engineering, exploit scaffolding, OSINT, and reporting via JSON-RPC over stdio, enabling LLMs to orchestrate evidence-based security workflows without executing targets or sending network requests.
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to locally analyze and reverse engineer binaries through a compact 12-tool MCP interface for triage, function discovery, disassembly/decompilation, cross-references, strings/imports, call graphs, memory reads, annotations, and binary diffs.
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI coding agents to inspect and reverse-engineer large binaries through bounded stdio JSON-RPC 2.0 tools for graph queries, SSA facts, path solving, runtime grounding, and mod scaffolding.
      1
      AGPL 3.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to debug Commodore software in a locally running VICE emulator through its text remote monitor, inspecting registers, memory and screens, disassembling code, setting breakpoints and watchpoints, controlling execution, and working with disk images, snapshots and exported graphics. Runs locally over stdio and includes safety guidance for state-changing operations.
      45 npm
      MIT