package
Tool server giving coding agents full control of homebrew ROM development AND reverse-engineering/romhacking across 18 retro platforms (NES, SNES, GB, Genesis, Atari, C64, PC Engine, MSX, GameTank, sync32, PlayStation, N64, Dreamcast, ...) via WASM toolch
npm install romdevtoolsGitHub-flavored package documentation.
Across all versions.
Download trend unavailable.
Runtime metadata.
Tagged topics.
romdevtools is the romdev tool server. It lets a coding agent (or you) build, run, debug, reverse-engineer and recompile retro console games: NES, SNES, Game Boy and Game Boy Color, GBA, Genesis, Master System, Game Gear, Atari 2600, 7800 and Lynx, C64, PC Engine, MSX, GameTank, sync32, and the 3D consoles N64, PlayStation and Dreamcast, plus PICO-8 and the wasmcart and jsgame runtimes. Every compiler, emulator core and analysis engine is bundled as WebAssembly.
npx romdevtoolsThe server listens on http://127.0.0.1:7331 (PORT and HOST override it). Node 24 or newer. ROMDEV_GPU=<PCI address> (or one line in $XDG_CONFIG_HOME/romdev/gpu) keeps every GPU library on one GPU on a machine with two; ROMDEV_HOST_WORKERS=0 runs every session's host in the server process instead of a process per session.
38 tools, each a verb with an operation axis (memory({op:'search'}), disasm({target:'cfg'}), build({output:'run'})):
examples({op:'fork'}); build({output:'run'}) builds, loads, runs and screenshots in one call. ROMs come out with the headers and checksums real hardware checks.disasm({target:'project'}) plus build({output:'reassemble'}) for a byte-identical rebuild on the 15 classic platforms; ROM patching with re-injection of compressed assets; custom-font text tools.disasm({target:'functions'|'cfg'|'xrefs'|'reachable'|'decompile'}), symbols({op:'analyze'})). breakpoint({on:'jumptable'}) resolves computed-jump dispatchers by running the game.disasm({target:'recompile', emit:'wasmcart'}) recompiles a whole NES, SNES (with its coprocessors), Game Boy, Game Boy Color, GBA, Master System, Game Gear or Genesis ROM into a playable wasmcart. frame({op:'verifyRecompile'}) checks it against the reference core (pixels, memory, audio, must-fail controls; auto:true picks the input itself), and findDiverge (down to level:'instruction'), , and find and measure differences. A Genesis ROM can also be built as a native sync32 cart (). exports decoded instructions for your own tools.Detailed guides are served in session: platform({op:'doc', platform, name:'mental_model'|'troubleshooting'}) per platform, platform({op:'doc', platform:'romhacking', name:'playbook'}), and platform({op:'doc', platform:'guide', name}) for recompile, debugging, assets, music, wasmcart, bezels and sessions.
http://127.0.0.1:7331/mcp. For Claude Code: claude mcp add --transport http romdev http://127.0.0.1:7331/mcp. Other clients are listed in the repository README. The session-based protocol and the stateless 2026-07-28 revision are both served; on the stateless revision pass one stable session argument on every call. The server sends AGENTS.md as its connection instructions.POST /tool/{name} with the arguments as a JSON body. Send an x-romdev-session header on every call (required; without it you get a 401). Pick one unique, descriptive id per task; it keeps your emulator between calls and labels your work on /livestream. When running many sessions, also send a stable x-romdev-agent header so eviction at the caps takes your own idle sessions, and end each with host({op:'shutdown'}). GET /openapi.json is the spec and GET /documentation a local Swagger UI. Errors come back as non-2xx responses with the reason.GET /skills/romdev/SKILL.md is an Agent Skills file generated from the running server. Save it in your agent's skills directory; it costs little context until used.romdev runs on the same machine as your agent. Path arguments (path, outputPath, ...) are local filesystem paths, not uploads.
romdevtools (the server; romdev-mcp is an alias) and romdevtools-cli (romdevtools-cli play <rom> opens an SDL window with hot-plugged controllers and live fps).This package contains no emulator or compiler WebAssembly. Those ship in the romdev-* packages below, and each platform's binaries load the first time you use that platform.
Exact-pinned, so one install is a matched set:
romdev-core-{fceumm,gambatte,gpgx,vice,handy,prosystem,geargrafx,bluemsx,gametank,bsnes,fake08,s32core} and the GPU cores romdev-core-{parallel-n64,beetle-psx-hw,flycast}. romdev-core-bsnes is an alternate SNES core (loadMedia({platform:'snes', core:'bsnes'})), the accuracy reference for the ST010/ST011/ST018 coprocessors.romdev-core-host, romdev-core-runner.romdev-platform-{snes,gba,atari2600,sync32}.romdev-toolchain-{cc65,sdcc,rgbds,m68k-gcc,mips-gcc,sh-gcc,decomp-gcc}.romdev-analysis (Rizin) and romdev-analysis-decompiler (Ghidra decompiler and SLEIGH specs).romdev-m2c, romdev-permuter and romdev-splat, which bring in romdev-spimdisasm, romdev-rabbitizer and romdev-pycparser.romdev-famitone, romdev-maxmod, romdev-xgm2, romdev-audio-resampler.romdev_game_codes, the cheat database, loaded one platform at a time.native-gles and webgl-node, required (the 3D cores and GL wasmcarts render through them).wasmcart and rungame; for Active Bezels (loaded only when one is attached)."license": "SEE LICENSE IN NOTICE". romdev's own code is MIT (LICENSE). The third-party components bundled or depended on keep their own licences, listed in NOTICE.
Games you build with romdev are yours, including to sell. Carts made by the static recompiler are different: they contain code ported from the reference emulator (GPL, MPL or non-commercial terms, by platform) as well as the original game's code. Each recompiled cart carries a licence entry naming those components; the texts are in LICENSES/ and the terms are explained in NOTICE.
fuzzRecompiletraceInstructionscyclesemit:'sync32'emit:'ir'decomp({op}) runs the generate, compile, compare, search and integrate loop on a splat-based N64 or PlayStation project, using the project's own compiler as WebAssembly with the flags its Makefile chooses: IDO 5.3/7.1, KMC gcc 2.7.2, EGCS 1.1.2, PS1 gcc 2.6.3 with maspsx, mips-linux-gnu gcc 14, with armips and the mips-linux-gnu binutils. setup runs a fresh checkout's extraction in process. m2c, decomp-permuter, splat and spimdisasm run as JavaScript ports. No Python, make or host compiler is used. Project state lives in ~/.romdev/decomp/<project>/. IDO is SGI's proprietary compiler and is not distributed: build it from a romdev source checkout with scripts/build-ido.sh, or set ROMDEV_IDO_DIR to your build. Start with platform({op:'doc', platform:'n64', name:'decomp'}).encodeArt), Aseprite/LibreSprite, Tiled, GIF and TexturePacker import (importArt), multi-sprite character capture (sprites({op:'capture'})), and audio for each platform (encodeAudio: SNES BRR and SPC driver data, Genesis XGM2 music and PCM, GBA maxmod soundbanks, NES FamiTone2, note tables for the other sound chips, sync32 synth and PCM)..wasc, WebAssembly games from any language, with GL and WebGPU rendering; ABI v4 required) and jsgame (JavaScript canvas and WebGL games) on the same load, step, screenshot and input loop. wasm({op}) validates a cart (conformance), reads its named debug state, drains its event log and talks to it over a command channel. loadMedia({deterministicSeed, deterministicStepMs}) gives replayable runs for regression({op:'capture'|'check'}) goldens. pack({target:'wasc'|'jsgame'}) builds the archive; you bring your own compiler.frame({op:'timing'}) times a span of frames in one call: wall, CPU and GPU time per frame (min/mean/p50/p95/p99/max, windows, the worst frame) from WebGPU timestamp queries or GL timer queries, with the cart's own pass timers, A/B variants, and the contention and the GPU that did the work reported beside the numbers. frame({op:'flash'}) checks a range of frames for photosensitive flashing (WCAG 2.3.1 and Harding thresholds) against a strobe control that must fail; frame({op:'record'}) writes the range to one file. Each session's host runs in its own process, so a crash or a long call in one session never touches another..p8 and .p8.png carts. build({platform:'pico8', source}) packages Lua into a .p8; disasm({target:'source'}) returns a cart's Lua..ab companion packages that read the game's memory every frame and draw a composite scene. frame({op:'screenshot', source:'both'}) returns the composite and the raw core frame for the same frame so a bezel's reading of the game can be checked.playtest() opens an SDL window on the running game, with gamepads, while the agent keeps working. host({op:'play', seconds}) shows a session moving on the /livestream page.active-bezel@kmamal/sdl for the playtest window. npm skips its binary download when romdevtools is installed through npx, so romdevtools' postinstall fetches it and playtest() retries at run time. If the binary cannot be fetched, only the window is affected and the error names the command that fixes it.Estimated unpacked size across 65 packages.
435.0 MB+
Includes dependencies.
^4.8.3
4.8.4
^0.0.18
0.0.19
0.1.0
0.1.0
^1.7.0
1.7.1
^0.11.13
0.11.13
^0.6.1
0.7.1
0.2.2
0.2.2
^0.10.1
0.10.1
0.1.0
0.1.0
0.2.1
0.2.1
0.2.2
0.2.2
0.2.1
0.2.1
0.1.0
0.1.0
^5.17.14
5.35.0
0.15.2
0.15.2
0.14.1
0.14.1
0.12.1
0.12.1
0.1.0
0.1.0
0.9.2
0.9.2
0.1.2
0.1.2
0.1.1
0.1.1
0.13.2
0.13.2
0.2.19
0.2.19
0.9.2
0.9.2
0.4.2
0.4.2
0.2.2
0.2.2
0.14.1
0.14.1
^0.4.0
0.4.0
0.12.2
0.12.2
0.5.2
0.5.2
0.12.2
0.12.2
0.10.2
0.10.2
0.10.2
0.10.2
0.1.5
0.2.3
0.1.1
0.2.2
0.1.3
0.1.3
0.3.2
1.32.2
0.3.2
0.10.2
0.4.2
0.1.3
2.1.2
0.2.2
0.1.0
2.4.0