Tool — dis

SkillDev tools

z88dk-dis disassembler for binaries/objects. Use to inspect codegen and library expansion.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Tool — dis skill

What this skill tells your AI

The instructions your AI receives, as published by z88dk/z88dk in .agents/skills/tool-dis/SKILL.md and read by ahel’s review.

Binaryz88dk-dis
Helpbare z88dk-dis usage
Wiki (local draft)wiki/tools/Tool-z88dk-dis.md

Prefer assembler -l listings for library sources. Use dis for linked binaries with map context when needed.

Condensed reference (from wiki / tree)

Tool — dis (z88dk-dis)

Multi-CPU disassembler. Load map/symbol files for named labels. Use with assembler listings when you need to see expanded synthetics in library sources.

Help path

Bare invocation prints usage. Do not assume a uniform -h.

z88dk-dis -mz80 program.bin
z88dk-dis -x program.map -o 0x8000 -s 0x8000 program.bin
z88dk-dis -m8085 program.bin

Put -x map/symbol before -o / -s / -e when symbols should apply to those addresses.

CPU flags

Use the -m… form (same family as ticks/zcc): -m8080, -m8085, -mgbz80, -mz80, -mz80n, -mz180, Rabbit, kc160, ez80 modes, …

Methodology

GoalApproach
See what linked at an address-x prog.map + start address from the map
Check 8085 vs Z80 opcodesMatch -m to the binary
Verify synthetics in a source filePrefer z88dk-z80asm -m8085 -l file.asm and read the .lis opcodes (for example ld a,(de+)1A 13)
Compare two buildsDisassemble the same range in both binaries

Assembler listing (often clearer for one module):

z88dk-z80asm -m8085 -l -o/tmp/x.o file.asm
# inspect file.lis

Live usage text

z88dk disassembler

z88dk-dis [+target] [options] [file]

  +target        Enable extended disassembly for target
  -x <file>      Symbol file to read
                 Use before -o,-s,-e to enable symbols
  -o <addr>      Address to load code to
  -s <addr>      Address to start disassembling from
  -e <addr>      Address to stop disassembling at

  -k <count>     Skip count bytes in the input file
  -mz80          Disassemble z80 code
  -mz180         Disassemble z180 code
  -mez80_z80     Disassemble ez80 (short) code
  -mez80         Disassemble ez80 ADL code
  -mz80n         Disassemble z80n code
  -mr2ka         Disassemble Rabbit 2000A code
  -mr3k          Disassemble Rabbit 3000 code
  -mr4k          Disassemble Rabbit 4000 code
  -mr5k          Disassemble Rabbit 5000 code
  -mr6k          Disassemble Rabbit 6000 code
  -mr800         Disassemble R800 code
  -mgbz80        Disassemble Gameboy z80 code
  -m8080         Disassemble 8080 code (with z80 mnemonics)
  -m8085         Disassemble 8085 code (with z80 mnemonics)
  -mkc160        Disassemble KC160
  -mkc160_z80    Disassemble KC160 in Z80 mode

Related

Related

  • Driver front end: tool-zcc
  • Measurement: methodology-measure, tool-ticks

Signals

GitHub stars
1k
Forks
206
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
tool-dis
Source
github.com/z88dk/z88dk