Skip to content
Back to search

regenerator2000

An interactive disassembler for the CPU 6502, focused on Commodore 8-bit computers. Features a TUI with modern features like x-ref, undo/redo, flow arrows, keyboard-driven, MCP server for auto analysis, VICE debugger and more!

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ricardoquesada/regenerator2000 with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ricardoquesada/regenerator2000'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ricardoquesada--regenerator2000/badge.svg)](/listings/ricardoquesada--regenerator2000)

HTML

<a href="/listings/ricardoquesada--regenerator2000"><img src="/api/listings/ricardoquesada--regenerator2000/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

From Crates.io

cargo install regenerator2000

From Source

git clone https://github.com/ricardoquesada/regenerator2000.git
cd regenerator2000
cargo install --path .

Quick Start with AI Agents

To quickly start analyzing binaries using an AI agent (such as Antigravity or Claude Code), you can use the [regenerator2000-template](https://github.com/ricardoquesada/regenerator2000-template) repository. It comes pre-configured with all the required skills and agent permissions so you can start analyzing and reverse-engineering binaries immediately.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 189 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Regenerator 2000
  2. ![Rust](https://github.com/ricardoquesada/regenerator2000/actions/workflows/rust.yml/badge.svg)
  3. [![Crates.io Version](https://img.shields.io/crates/v/regenerator2000)](https://crates.io/crates/regenerator2000)
  4. [![discord](https://img.shields.io/discord/775177861665521725.svg)](https://discord.gg/r5aMn6Cw5q)
  5. ![logo](docs/regenerator2000_logo.png)
  6. Regenerator 2000 is an interactive 6502 disassembler for Commodore 8-bit machines. It is inspired by the original [Regenerator][regenerator].
  7. - **⚡ Fast** — Starts immediately, navigates large binaries with zero lag, and updates control flow and cross-references in real time.
  8. - **⏪ Non-Destructive** — Tracks every edit in the undo history so you can experiment with code, data, and labels without risk.
  9. - **⌨️ Keyboard-First** — Navigate and edit with single-key shortcuts, arrow or Vim keys, and optional mouse support.
  10. It supports two primary workflows:
  11. - **🕹️ Manual Analysis** — Use the keyboard-centric terminal interface to navigate code, define data regions, label subroutines, add comments, and refine your disassembly.
  12. - **🤖 Automated Analysis** — Use the built-in MCP Server and analysis skills so AI assistants classify blocks, trace routines, and name symbols automatically.
  13. Use either workflow independently, or combine them. Run an initial pass with the AI, and then refine the results interactively.
  14. See the [Examples](https://regenerator2000.readthedocs.io/en/latest/examples/) page to inspect pre-disassembled games for different Commodore platforms.
  15. [regenerator]: https://csdb.dk/release/?id=247992
  16. ## Features
  17. Regenerator 2000 provides the following features for 6502 disassembly:
  18. - **Disassembly**: Supports the full 6502 instruction set and undocumented opcodes.
  19. - **Hex Dump**:
  20. - Displays a side-by-side view with the disassembly.
  21. - Supports synchronized or independent navigation.
  22. - Supports unshifted PETSCII, shifted PETSCII, and screencode character sets.
  23. - **Sprites**:
  24. - Displays a side-by-side view with the disassembly.
  25. - Supports multicolor and single-color modes.
  26. - **Bitmap**:
  27. - Displays a side-by-side view with the disassembly.
  28. - Supports high-resolution (320x200) and multicolor (160x200) modes.
  29. - Renders pixel graphics via Kitty, iTerm2, or Sixel protocols, with Halfblocks fallback.
  30. - **Charset**:
  31. - Displays a side-by-side view with the disassembly.
  32. - Supports multicolor and single-color modes.
  33. - **Blocks**:
  34. - Displays a side-by-side view with the disassembly.
  35. - **Debugger**: Connects to VICE for live disassembly, breakpoints, and step controls (F2–F9) in the right pane.
  36. - **Mini map**: Shows a mini map of the analyzed file.
  37. - **Systems**: Supports Commodore 8-bit machines: C64, C128, VIC-20, Plus/4, PET 4.0, PET 2.0, and 1541.
  38. - **Import**: Loads the following file formats:
  39. - PRG: Standard Commodore program files.
  40. - CRT: Cartridge images with bank selection support.
  41. - D64: 35-track, 40-track, and 42-track disk images.
  42. - D71: 70-track and 80-track double-sided disk images.
  43. - D81: 80-track disk images.
  44. - T64: Tape images.
  45. - VSF: VICE snapshot files.
  46. - RAW / BIN: Raw binary files.
  47. - DIS65: 6502bench project files.
  48. - REGEN2000PROJ: Regenerator 2000 project files.
  49. - **Binary Unpacker**: Emulates a cycle-accurate 6502 sandbox to decompress packed programs automatically.
  50. - **Export**: Exports projects to `.asm` or HTML for the following assemblers:
  51. - **64tass**
  52. - **ACME**
  53. - **Kick Assembler**
  54. - **ca65**
  55. - **Project Management**: Saves and loads project state.
  56. - **Analysis**: Runs auto-analysis to identify code and data regions.
  57. - **Editing**:
  58. - **Labels**: Adds, edits, and removes local and global labels.
  59. - **Enums**: Defines and applies System, Global, and Project value-to-name mappings to replace numeric literals with semantic names.
  60. - **Comments**: Adds side comments and line comments.
  61. - **Origin**: Changes the load address (origin) of the binary.
  62. - **Data Types**: Converts regions to Code, Byte, Word, Address, Lo/Hi Address, Hi/Lo Address, Lo/Hi Word, Hi/Lo Word, PETSCII Text, Screencode Text, External File, or Undefined.
  63. - **Undo/Redo**: Tracks full history for all actions.
  64. - **Navigation**:
  65. - **Jump**: Jumps to specific addresses, line numbers, or operand targets.
  66. - **X-Ref**: Inspects cross-references for labels and addresses.
  67. - **History**: Returns to previous locations.
  68. - **Customization**:
  69. - Configures document settings (maximum x-refs, target system, and target assembler).
  70. - Customizes display options (such as label visibility).
  71. - **TUI**:
  72. - Provides a keyboard-driven terminal user interface.
  73. - **Visual Mode**: Supports Vim-style selection for batch operations.
  74. - **MCP Server**:
  75. - Provides Model Context Protocol (MCP) server support for programmatic access.
  76. - Supports HTTP and stdio transport modes.
  77. - Exposes tools for disassembly manipulation, memory search, and block operations.
  78. - Exposes resources to access binary data and views.
  79. - Includes analysis skills that automate block classification, routine tracing, and symbol naming.
  80. ![hexdump screenshot](docs/regenerator2000_hexdump_screenshot.png)
  81. ![charset screenshot](docs/regenerator2000_charset_screenshot.png)
  82. ![sprites screenshot](docs/regenerator2000_sprites_screenshot.png)
  83. ![bitmap screenshot](docs/regenerator2000_bitmap_screenshot.png)
  84. ![debugger screenshot](docs/regenerator2000_debugger_screenshot.png)
  85. ## Requirements
  86. ### Recommended Terminals
  87. Use a modern terminal to ensure full support for keyboard shortcuts and rendering.
  88. | Platform | Recommended Terminals |
  89. | :---------- | :------------------------------------------------- |
  90. | **Windows** | Windows Terminal, Alacritty, WezTerm |
  91. | **macOS** | iTerm2, Ghostty, Alacritty, kitty, WezTerm |
  92. | **Linux** | Ghostty, Alacritty, kitty, WezTerm, GNOME Terminal |
  93. ## Installation
  94. ### From Crates.io
  95. ```bash
  96. cargo install regenerator2000
  97. ```
  98. ### From Source
  99. ```bash
  100. git clone https://github.com/ricardoquesada/regenerator2000.git
  101. cd regenerator2000
  102. cargo install --path .
  103. ```
  104. ### Quick Start with AI Agents
  105. Use the [regenerator2000-template](https://github.com/ricardoquesada/regenerator2000-template) repository to analyze binaries with an AI agent (such as Antigravity or Claude Code). This template includes the required skills and agent permissions so you can analyze binaries immediately.
  106. ## Usage
  107. Start the application with an optional file path:
  108. ```bash
  109. regenerator2000 [OPTIONS] [path/to/file.prg]
  110. ```
  111. ## CLI Options
  112. - `--help`: Print the help message.
  113. - `--version`: Print version information.
  114. - `--import_lbl <PATH>`: Import VICE labels from the specified file.
  115. - `--export_lbl <PATH>`: Export labels to the specified file after analysis or import.
  116. - `--export_asm <PATH>`: Export assembly code to the specified file after analysis or import.
  117. - `--export_html <PATH>`: Export HTML to the specified file after analysis or import.
  118. - `--assembler <NAME>`: Override the assembler format for export (`64tass`, `acme`, `ca65`, or `kick`).
  119. - `--headless`: Run in headless mode without the TUI for batch processing.
  120. - `--verify`: Verify export roundtrip (export, assemble, and compare) for all assemblers. This flag implies `--headless`.
  121. - `--mcp-server`: Run the MCP server over HTTP on port 3000.
  122. - `--mcp-server-stdio`: Run the MCP server over stdio.
  123. - `--vice <HOST:PORT>`: Connect to the VICE binary monitor at startup (for example, `--vice localhost:6502`).
  124. - `--dump-system-config-files <PATH>`: Write all built-in system configuration files (`system-*.toml`) to the specified directory and exit.
  125. - `--dump-theme-files <PATH>`: Write all built-in theme files (`theme-*.toml`) to the specified directory and exit. Place modified files in the [config directory](https://regenerator2000.readthedocs.io/en/latest/install/) to create custom themes.
  126. - `--dump-enum-files <PATH>`: Write all built-in enum files (`enum-*.toml`) to the specified directory and exit. Place modified files in the [config directory](https://regenerator2000.readthedocs.io/en/latest/install/) to create custom enums.
  127. Supported file formats: `.prg`, `.crt`, `.d64`, `.d71`, `.d81`, `.t64`, `.vsf`, 6502bench (`.dis65`), `.bin`, `.raw`, and `.regen2000proj`.
  128. ## Keyboard Shortcuts
  129. See the [Keyboard Shortcuts](https://regenerator2000.readthedocs.io/en/latest/keyboard_shortcuts/) page for the complete list of shortcuts.
  130. ## Support and Documentation
  131. - [Documentation](http://regenerator2000.readthedocs.io/)
  132. - [Examples](https://regenerator2000.readthedocs.io/en/latest/examples/): View disassembled Commodore games and software across supported platforms.
  133. - [Support in Discord][discord]: Join the `#regenerator2000` channel under **"Misc Projects"**.
  134. [discord]: https://discord.gg/r5aMn6Cw5q
  135. ## Contributing
  136. Submit a Pull Request to contribute changes.
  137. ## Acknowledgements
  138. - [Regenerator][regenerator]: The original 6502 disassembler for Windows.
  139. - [unp64][unp64]: The C64 binary unpacker by iAN CooG that forms the basis of the unpacker module.
  140. - [64tass][64tass], [ACME][ACME], [Kick Assembler][Kick Assembler], [ca65][ca65]: Supported assemblers.
  141. [unp64]: https://csdb.dk/release/?id=260619
  142. [64tass]: https://tass64.sourceforge.net/
  143. [ACME]: https://sourceforge.net/projects/acme-crossass/
  144. [Kick Assembler]: http://www.theweb.dk/KickAssembler/
  145. [ca65]: https://cc65.github.io/
  146. ## License
  147. Dual license: MIT and Apache 2.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.