Repository navigation
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):
diagnames the machine, its ACPI devices and its power-off registers;diagplaces any DMA fault against the driver's own memory;acpidumpsaves 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,upgradeandreboot. This index names the desktop profile for the first time, soupdate profile add desktop, thenupdateandupgrade, 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
profileline. Go to 0.18.0 first: runupdate add https://github.com/AriCodeLabs/AriCodeOS/releases/download/v0.18.0/, thenupdate,upgradeandreboot, then remove that source again withupdate remove. - USB sticks. Decompress with
xz -dfirst, write to a stick you can wipe, then boot a UEFI x86-64 machine with Secure Boot off (seedocs/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, andsession shellgoes back to the console.- For a Spanish keyboard, add
kbd=estoaricodeos/cmdline.txton the stick's EFI partition.
- Container:
docker run --rm -it ghcr.io/aricodelabs/aricodeos:0.19.0boots the base stick in QEMU, with theari>shell on your terminal (quit with Ctrl-A X).
Files
aricodeos-20.img,index,index.sigand the five*-6.aripkgpackages: the public update source, signed with the release key (keys/release/).aricodeos-0.19.0-usb.img.xzandaricodeos-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.