A cross-platform Zelda 3 ROM editor with a modern C++ GUI, Asar 65816 assembler integration, and an automation-friendly CLI (z3ed). YAZE bundles its toolchain, offers AI-assisted editing flows, and targets reproducible builds on Windows, macOS, and Linux. A preview web version is also available for browser-based editing.

• All-in-one editing: Overworld, dungeon, sprite, palette, and messaging tools with live previews.
• Assembler-first workflow: Built-in Asar integration, symbol extraction, and patch validation.
• Automation & AI: z3ed exposes CLI/TUI automation, proposal workflows, and optional AI agents.
• Web preview: Experimental browser-based editor (WASM) - see Web App Guide.
• Testing & CI hooks: CMake presets, ROM-less test fixtures, and gRPC-based GUI automation support.
• Cross-platform toolchains: Single source tree targeting MSVC, Clang, and GCC with identical presets.
• Modular AI stack: Toggle agent UI (YAZE_BUILD_AGENT_UI), remote automation/gRPC (YAZE_ENABLE_REMOTE_AUTOMATION), and AI runtimes (YAZE_ENABLE_AI_RUNTIME) per preset.

0.5.0-alpha builds are in active development, focusing on the new Music Editor, Web Assembly port, and SDL3 migration. See docs/public/release-notes.md for details.

git clone --recursive https://github.com/scawful/yaze.git
cd yaze

Run the environment verifier once per machine:

# macOS / Linux
./scripts/verify-build-environment.sh --fix

# Windows (PowerShell)
.\scripts\verify-build-environment.ps1 -FixIssues

• Use the CMake preset that matches your platform (mac-dbg, lin-dbg, win-dbg, etc.).
• Build with cmake --build --preset <name> [--target …].
• See docs/public/build/quick-reference.md for the canonical list of presets, AI build policy, and testing commands.

Windows win-* presets keep every switch OFF by default (win-dbg, win-rel, ci-windows) so MSVC builds stay fast. Use win-ai, win-vs-ai, or the new ci-windows-ai preset whenever you need remote automation or AI runtime features.

All bundled third-party code (SDL, ImGui, ImGui Test Engine, Asar, nlohmann/json, cpp-httplib, nativefiledialog-extended) now lives under ext/ for easier vendoring and cleaner include paths.

• ./build/bin/yaze – full GUI editor with multi-session dockspace, theming, and ROM patching.
• Web App (Preview) – browser-based editor at your deployed instance; see docs/public/usage/web-app.md for details and limitations.
• ./build/bin/z3ed --tui – CLI/TUI companion for scripting, AI-assisted edits, and Asar workflows.
• ./build_ai/bin/yaze_test --unit|--integration|--e2e – structured test runner for quick regression checks.
• z3ed + macOS automation – pair the CLI with sketchybar/yabai/skhd or Emacs/Spacemacs to drive ROM workflows without opening the GUI.

Typical commands:

# Launch GUI with a ROM
./build/bin/yaze zelda3.sfc

# Apply a patch via CLI
./build/bin/z3ed asar patch.asm --rom zelda3.sfc

# Run focused tests
cmake --build --preset mac-ai --target yaze_test
./build_ai/bin/yaze_test --unit

• ./build_ai/bin/yaze_test --unit for fast checks; add --integration or --e2e --show-gui for broader coverage.
• ctest --preset dev mirrors CI’s stable set; ctest --preset all runs the full matrix.
• Set YAZE_TEST_ROM_PATH or pass --rom-path when a test needs a real ROM image.

• Human-readable docs live under docs/public/ with an entry point at docs/public/index.md.
• Run doxygen Doxyfile to generate API + guide pages (build/docs/html and build/docs/latex).
• Agent playbooks, architecture notes, and testing recipes now live in docs/internal/.

• Review CONTRIBUTING.md and the build/test guides in docs/public/.
• Conventional commit messages (feat:, fix:, etc.) keep history clean; use topic branches for larger work.
• Chat with the team on Oracle of Secrets Discord.

YAZE is licensed under the GNU GPL v3. See LICENSE for details and third-party notices.