MOS 6502 & MOS 6510 CPU Core: Emulation of instruction execution, registers, and memory addressing modes.
ALU & Opcodes: Full support for standard and illegal/undocumented opcodes.
Disassembler: Instruction disassembler for 6502 assembly inspection.
Conformance Suite: Built-in verification and test suite.
Modular Architecture: Clean module organization separating CPU emulation, system platforms, and frontends.

Requirements

Zig: 0.16.0 or newer

Getting Started

Building

Build the project using Zig:

zig build

Running Tests

Run the full unit and conformance test suite:

zig build test

Project Structure

src/
├── cpu/          # MOS 6502/6510 CPU implementation, opcode decoders, disassembler
├── system/       # System-level integrations (e.g., NES, C64)
├── platform/     # Platform abstractions
└── frontend/     # UI / CLI frontends

License

This project is licensed under the MIT License.