{"slug": "booleos-building-a-bare-metal-x86-os-without-writing-a-single-line-of-it-myself", "title": "BooleOS: building a bare-metal x86 OS without writing a single line of it myself", "summary": "A developer has built BooleOS, a bare-metal 32-bit x86 hobby operating system written in C99 and NASM with no Linux, BSD, or libc underneath, where every line of implementation is AI-generated via Claude Code. The project boots through Multiboot2 and includes its own heap manager, a FAT16/VFS layer, and a cooperative scheduler, with roughly 20 tagged pre-release versions so far. The developer directs the agent, reviews every diff, and does all testing personally in QEMU, with AI-generated contributions required by the project's CONTRIBUTING.md.", "body_md": "BooleOS is a hobby operating system for x86 (32-bit), written in C99\n\nand NASM, no Linux or BSD underneath, no libc. It boots via\n\nMultiboot2, has its own heap manager (no raw malloc), a FAT16/VFS\n\nlayer, and a cooperative scheduler so far. Repo:\n\n[https://github.com/BooleSystems/BooleOS](https://github.com/BooleSystems/BooleOS)\n\nI don't write the code. I direct Claude Code, review every diff, and\n\ndecide what gets built next, but the implementation, every commit, is\n\nAI-generated. This isn't a detail I'm downplaying, it's written into\n\nthe project's own CONTRIBUTING.md: contributions have to be\n\nAI-generated too, with a verifiable co-author trailer in the commit,\n\nor they get closed on sight.\n\nMost \"I built this with AI\" posts are about apps with a framework,\n\na runtime, a garbage collector, and years of guardrails baked in.\n\nBare-metal has none of that. There's no libc to catch a bad pointer,\n\nno OS underneath to kill a runaway process, and the debugger you'd\n\nnormally reach for doesn't exist yet because you're the one building\n\nthe platform it would run on.\n\nThat changes what \"reviewing AI output\" actually means here. A few\n\nconstraints I hold non-negotiable, written into the project's own\n\nCLAUDE.md so every session (including future me) doesn't have to\n\nrelearn them:\n\n`sizeof(void*) == 8` assumptions, ever.`<stdint.h>`,\nnever `size_t` or `long`.\nThe two mistakes an AI agent keeps drifting toward, if I don't stay\n\nstrict about it: reaching for `pthread` and `malloc` because they're\n\nconvenient on Linux, and treating the 64-bit dev build as the one\n\nthat matters because that's where the debugger runs.\n\nI don't hand off a feature request and walk away. For anything that\n\ntouches the kernel, I write out the constraint set in the prompt\n\nexplicitly (32-bit gate, fixed-width types, no libc), it implements,\n\nI boot it in QEMU myself, read the serial output myself, and only\n\nthen decide the next step. Testing is never delegated, ever.\n\nPre-release, not a 1.0, but with ~20 tagged versions and real\n\nchangelogs behind each one. Currently at about USB HID input work,\n\nheading toward a custom graphics API (Cathode) and eventually a\n\nminimal GUI on top of it.\n\nHappy to go deeper on any part of this, the constraint-writing\n\nprocess, the heap wrapper design, or what a \"cooperative scheduler\n\nnow, real SMP model later\" migration path looks like when none of\n\nthe code was hand-typed to begin with.", "url": "https://wpnews.pro/news/booleos-building-a-bare-metal-x86-os-without-writing-a-single-line-of-it-myself", "canonical_source": "https://dev.to/shannondev/booleos-building-a-bare-metal-x86-os-without-writing-a-single-line-of-it-myself-11g", "published_at": "2026-09-26 03:38:04+00:00", "updated_at": "2026-09-26 04:00:38.312166+00:00", "lang": "en", "topics": ["artificial-intelligence", "ai-agents", "ai-tools", "developer-tools"], "entities": ["BooleOS", "Claude Code", "BooleSystems", "QEMU", "Multiboot2", "Cathode", "GitHub"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/booleos-building-a-bare-metal-x86-os-without-writing-a-single-line-of-it-myself", "markdown": "https://wpnews.pro/news/booleos-building-a-bare-metal-x86-os-without-writing-a-single-line-of-it-myself.md", "text": "https://wpnews.pro/news/booleos-building-a-bare-metal-x86-os-without-writing-a-single-line-of-it-myself.txt", "jsonld": "https://wpnews.pro/news/booleos-building-a-bare-metal-x86-os-without-writing-a-single-line-of-it-myself.jsonld"}}