name	run-slopos
description	Run the slopos BIOS/MBR bootloader in QEMU headless mode, rebuild the boot image when needed, and troubleshoot common run failures (missing packages, QEMU display errors, locked images, or stuck runs). Use when the user asks to run, boot, or verify slopos output.

Run Slopos

Run the slopos bootloader in QEMU headless mode and verify the text harness output.

Run make run.
Expect the harness to print SLOPOS BOOT, Text Harness, and All tests passed.
To quit headless QEMU, press Ctrl-A then X.

If QEMU fails with GTK/display errors, ensure the run command uses -nographic -serial stdio -monitor none.
If QEMU reports a write lock on build/os.img, find and stop the existing QEMU process.
If output is missing, rebuild with make clean && make and re-run.

Confirm nasm and qemu-system-x86 are installed on Ubuntu.
Confirm the boot sector signature 0xAA55 exists in the last two bytes of build/bootloader.bin.

name	run-slopos
description	Run the slopos BIOS/MBR bootloader in QEMU headless mode, rebuild the boot image when needed, and troubleshoot common run failures (missing packages, QEMU display errors, locked images, or stuck runs). Use when the user asks to run, boot, or verify slopos output.

Run the slopos bootloader in QEMU headless mode and verify the text harness output.

Run make run.
Expect the harness to print SLOPOS BOOT, Text Harness, and All tests passed.
To quit headless QEMU, press Ctrl-A then X.

If QEMU fails with GTK/display errors, ensure the run command uses -nographic -serial stdio -monitor none.
If QEMU reports a write lock on build/os.img, find and stop the existing QEMU process.
If output is missing, rebuild with make clean && make and re-run.

Confirm nasm and qemu-system-x86 are installed on Ubuntu.
Confirm the boot sector signature 0xAA55 exists in the last two bytes of build/bootloader.bin.

run-slopos