Manual CLI Workflow

You can use zx-vibes as a normal command-line toolkit without an agent.

Edit the main program:

code src/main.asm

Build:

npm run build

Run for 300 frames and save a screenshot:

npm run run

Inspect the current session screen as text and PNG:

npm run screen

Schedule input when testing controls:

zxs run --bin build/main.bin --org 0x8000 --frames 300 --keys "10:P*30,60:SPACE*5" --json

Run declarative tests:

npm test

List supported assertions:

zxs test tests --list-assertions

Verify everything:

npm run verify

Standalone Assembler

The default backend is @zx-vibes/asm, a TypeScript Z80 assembler and disassembler that works without native dependencies. Use zxasm directly when you want the standalone assembler CLI:

zxasm assemble src/main.asm -I lib --out-dir build
zxasm disasm build/main.bin --org 0x8000 --count 32
zxasm doctor

The embedded backend name in zxs build --assembler remains spectral for compatibility with older configuration. spectral-asm also remains a bin alias for zxasm.

For projects that need a sjasmplus feature, install sjasmplus separately and select it with either:

ZXS_ASSEMBLER=sjasmplus zxs build
zxs build --assembler sjasmplus

The starter projects are designed to work with the embedded assembler by default.