DOCUMENTATION

The tools. The workflow. The details.

Find a specific operation, understand what it changes and check the result. Start with the AI Field Guide for step-by-step development scenarios.

LOOKING FOR AI?

Follow a complete task, not just a command.

Setup, project design, BASIC, Z80, graphics, music, debugging and export.

Open the AI Field Guide →

10 areas

REFERENCE AREA

Projects & workspace

Project lifecycle, portable packages, templates, workbench, search and recovery.

8 topics

Create 48K and 128K projects The .zxproj package Project Navigator Tabs and split editors Quick Open and Command Palette Build and Run configurations Autosave and interrupted-save recovery Local History

REFERENCE AREA

Sinclair BASIC

Language-aware editing, authentic source entry, navigation and safe transformations.

8 topics

Line numbers and replacement semantics Completion and formatting Diagnostics and semantic rules Go to Definition and references Renumber and rename Subroutine extraction Embedded Spectrum characters BAS, TAP and WAV import

REFERENCE AREA

Z80 Machine Code

Source authoring, SJAsmPlus, routine contracts, code acceptance and BASIC calls.

9 topics

Create an assembly module Supported SJAsmPlus source Blocked directives and isolation Instruction Quick Help Assemble, test and accept Pausable routine tests Source maps and symbols Memory map and collisions Banked 128K placement

REFERENCE AREA

Build, TAP & WAV

Deterministic build artifacts, tape layout, loaders and distribution outputs.

8 topics

Build graph and freshness Tape Layout Editor Smart loader dependencies 128K banked loader review Generate and inspect TAP Export WAV Distribution archives Sinclair listing PDF

REFERENCE AREA

Graphics & UDG

The 256×192 display, 8×8 attributes, loading screens and generated drawing code.

9 topics

SCREEN$ library Convert PNG and JPEG Graphic Editor Editable text layers Colour clash and attributes Use as loading screen Import and export SCR UDG slots A–U Generate BASIC or Z80

REFERENCE AREA

Runtime

Integrated project execution for the original 48K and 128K machine profiles.

8 topics

Instant Load Run, Stop and Reset Pause and Continue Virtual keyboard Display scale and detach 48K beeper 128K memory banking AY audio path

REFERENCE AREA

Debugger & tests

Language-to-machine stepping, observability and deterministic project evidence.

10 topics

BASIC breakpoints Z80 source breakpoints Logical and banked addresses Stepping commands Registers and disassembly BASIC variables and watchpoints 48K timing telemetry 128K timing inspector Deterministic project tests Bank-aware assertions

REFERENCE AREA

Music Studio

Piano roll, composition, recording review, source linking and target-aware generation.

14 topics

Compositions and patterns Piano roll Pattern order Realtime piano MIDI input Timed recording Review recorded notes Keep Take drafts Generate BASIC Link music to main Generate target-aware ASM Target conversion AY effects export Data-only export

REFERENCE AREA

AI assistance

Provider setup, targeted code proposals and practical guides for every development phase.

11 topics

Configure a provider Project assistant sidebar Command-K context BASIC and Z80 actions Patch and hunk review Apply, Reject and Undo Full Program Assistant Game Project Agent Credential storage Privacy and redirect safety AI development field guide

REFERENCE AREA

Reference & support

Formats, shortcuts, compatibility boundaries and troubleshooting.

8 topics

Keyboard shortcuts Supported file formats 48K memory map 128K bank model Spectrum character notation TAP block format Troubleshooting Release evidence boundaries