Skip to content

AriCodeOS 0.19.0

Latest

Choose a tag to compare

@Lynx-Boss Lynx-Boss released this 21 Nov 01:22

AriCodeOS 0.19.0 (2026-11-21) is the version of a desktop worth the name (ADR 0078), of the first steps onto the reference laptop's GPU (ADR 0080, 0083, 0086), and of what a second laptop, a Tiger Lake Lenovo, taught. It covers ten ADRs (0078 to 0087) and incidents 0059 to 0066. The whole system passed its full test suite with 1 and with 4 CPUs, and the development build it comes from ran on the reference laptop, a 2013 ASUS with a Core i3-3217U.

Website: https://www.aricodeos.org/ · Master document: AriCodeOS.md, section 94.19.

What is new

  • The desktop (ADR 0078, 0079, 0081, 0085):
    • a toolkit of its own, with Inter and JetBrains Mono, menus, modal dialogs, a clipboard, a dark appearance and notices;
    • a bar with a clock, and a dock that offers the applications;
    • windows drawn in two buffers, so no frame is shown half drawn;
    • windows resized by their edges and corners, and full screen with F11 or a window's zoom circle;
    • the panel's own resolution when the firmware does not offer it.
  • The owner's remote screen: screenshot, from the console, an SSH session or the Terminal, prints the screen as a QOI image in Base64. Applications cannot ask for it, there is at most one copy every 2 s, and the screen says when a copy was taken.
  • USB plug and play on the xHCI (ADR 0087):
    • a keyboard or mouse plugged in while the system runs works without a reboot;
    • unplugged, it releases every key and button it held;
    • the boot stick is never put at risk by it.
  • One path to the hardware (ADR 0080):
    • threads in a process (ADR 0082) and memory for big programs (ADR 0084);
    • a software 3D renderer that draws in bands on every processor.
  • The HD 4000 GPU (Intel Ivy Bridge only):
    • its engine is driven by the kernel, with its clock and a heat brake (ADR 0083);
    • compute runs on its EUs, and their registers are cleared between clients (ADR 0086).
    • Other GPUs are left as the firmware set them.
  • Power-off (incident 0065):
    • it now runs as Linux and FreeBSD run it: on the boot CPU, with the GPEs disabled, in two writes, and with the FADT's extended blocks read;
    • if the power still stays on, the last line on the screen says why.
  • Diagnostics (incident 0064):
    • diag names the machine, its ACPI devices and its power-off registers;
    • diag places any DMA fault against the driver's own memory;
    • acpidump saves the DSDT, SSDTs and FADT, never MSDM, SLIC or serial numbers.
  • Measured on real hardware (docs/performance.md, run bench). On the reference laptop's Core i3-3217U:
    • two threads exchange 218 000 to 237 000 IPC messages a second;
    • a request to a service in another process takes 17 to 23 µs;
    • an empty system call takes 260 ns.
  • The heap is TLSF in the kernel and in programs (incident 0066). Large allocations no longer turn quadratic.
  • Certificates:
    • Mozilla's roots, from NSS master, are 112. Buypass Class 2 and 3, Certigna, and QuoVadis Root CA 1 G3 and 3 G3 left Mozilla's store.
    • The public suffix list is current.

Trying it

  • From 0.18.0: run update, upgrade and reboot. This index names the desktop profile for the first time, so update profile add desktop, then update and upgrade, installs the desktop's apps, on sticks with AriFS v2.
  • From 0.17.0 or earlier: these updaters refuse an index with a line they do not know, such as this one's profile line. Go to 0.18.0 first: run update add https://github.com/AriCodeLabs/AriCodeOS/releases/download/v0.18.0/, then update, upgrade and reboot, then remove that source again with update remove.
  • USB sticks. Decompress with xz -d first, write to a stick you can wipe, then boot a UEFI x86-64 machine with Secure Boot off (see docs/hardware.md).
    • aricodeos-0.19.0-usb.img.xz: the base system, with the text console.
    • aricodeos-0.19.0-desktop-usb.img.xz: the same system with the desktop profile installed. It boots into the desktop, and session shell goes back to the console.
    • For a Spanish keyboard, add kbd=es to aricodeos/cmdline.txt on the stick's EFI partition.
  • Container: docker run --rm -it ghcr.io/aricodelabs/aricodeos:0.19.0 boots the base stick in QEMU, with the ari> shell on your terminal (quit with Ctrl-A X).

Files

  • aricodeos-20.img, index, index.sig and the five *-6.aripkg packages: the public update source, signed with the release key (keys/release/).
  • aricodeos-0.19.0-usb.img.xz and aricodeos-0.19.0-desktop-usb.img.xz: the USB sticks.
  • THIRD-PARTY-NOTICES.txt: the licences of the crates.io crates and fonts the images include. It is on the sticks too.
  • SHA256SUMS: the checksums of all of the above.

Known limits

  • On the Tiger Lake Lenovo the new power-off has not been tried yet, and the cause of its xHCI's DMA fault waits for the next run.
  • External USB hubs on the xHCI, and a USB stick plugged in after boot, are not supported yet.
  • The kernel has no IPC fast path yet.
  • A PS/2 pointer that resets itself is set up again only at the next boot.
  • A program hung for good keeps its process until the desktop ends.

Authorship and acknowledgements

AriCodeOS is created by Edwin F. Veliz Jaramillo (lynxcraft), who conceived the system, its capability model, its architecture and its development method, directed every phase and tested it on real hardware. Code and documents were written with the help of AI coding assistants working under the author's direction; the design decisions and the responsibility for them are the author's (AUTHORS.md).

The author thanks the teams behind the AI technologies used to build AriCodeOS: Anthropic for Claude and Claude Code, OpenAI for Codex, and Google for Antigravity.