Skip to main content
Ganksoft Logo Ganksoft
Ganksoft · Tool

Gearlynx Debugger

A Visual Studio Code extension for source-level debugging of Atari Lynx games built with cc65, powered by the Gearlynx emulator.

OpenCross-Platform

Gearlynx Debugger brings full source-level debugging to Atari Lynx homebrew development. Built as a Visual Studio Code extension and powered by the Gearlynx emulator, it lets you debug C and 6502 assembly games compiled with the cc65 toolchain, right inside your editor.

Gearlynx Debugger does not bundle the emulator. Install Gearlynx separately and point the extension at it with the gearlynxDebug.gearlynxPath setting.

Features

  • Source-level debugging for C and 6502 assembly via cc65 .dbg files
  • Full step controls including step in/over/out, continue, pause, source-line stepping, and frame-level step back
  • Powerful breakpoints: source, conditional, hit count, logpoints, data/watchpoints, function, and instruction breakpoints
  • Variables and memory: CPU registers with individual flag bits, locals, globals, zero-page values, hardware status (Mikey timers, audio, LCD, cart), and memory inspection
  • Overlay support for Lynx segments/overlays, with a runtime overlay selector.
  • Live screen viewer streaming at 60fps in a dockable panel, with input forwarded to the emulator
  • Extra tooling: memory map visualization, CPU trace logging, and a loaded-sources list
Screenshots
Source-level debugging with screen viewer
Lynx memory map with segments