Okei OS

Okei OS

A 64-bit operating system built from scratch. We boot it in QEMU, VirtualBox, and a custom browser emulator — Multiboot2 kernel, Ext4, GNU Bash, and Okei Desktop. Pre-alpha and not public yet.

Half a million first-party lines HTTPS · scp · git Desktop click-paths QEMU · VirtualBox · web Open release soon
Status · 15 August 2026

Where the project is now

Private tree is a product-shaped OS: Bash, Okei Desktop, real networking, HTTPS/scp/git, and QEMU-proven desktop click-paths. Active engineering is a first-party house-clean — read every in-tree file, write contracts, file findings; review commits do not silently “fix.” Later host-unit children may wire helpers. On 9 August 2026 we first booted on a physical Raspberry Pi 5 with an HDMI text console (OKEIOS_AARCH64_FB_BOARD_OK). QEMU free-path SSH gates stay green; board userspace and headed Terminal free-path SSH polish continue.

Scale

  • Half a million first-party lines (509,590)
  • 3,491 files · 5,357 host unit tests
  • 102 syscalls · 103 multicall applets
  • 3,552 commits · ~30/day avg · 118 days

House-clean (13–15 Aug)

812 H children closed. 1,038 files on the ledger (of 3,491). 2,411 findings filed, not a fix list. Kernel ~82% + all of libc + more than half of Okei Desktop. Tests and scripts not started.

Solid today

CA-verified HTTPS, Dropbear scp, freestanding git, Vim/PTY/tmux, desktop click-paths + title-close + PPM/BMP, shared newlib + opt-in bash-dyn, VBox public ping / self-SSH / curl okeios.org. Product /bin/bash stays static.

Open residual

Rest of the house-clean (tests, scripts, leftover drivers/apps); Pi 5 board userspace; headed Terminal free-path SSH UX; headed remote X PRESENT. Not a public download.

Platform

What we've built so far

A private make all produces a bootable ISO with kernel, GNU userspace, and Okei Desktop. That image boots under QEMU, VirtualBox, and a web x86_64 emulator. Separately, an AArch64 flash image boots on a Raspberry Pi 5 to an HDMI boot console.

Oracle VirtualBox running Okei Desktop: app bar, Terminal at bash$ after curl okeios.org/helloworld prints Hello World! and Okei OS ASCII art
Okei Desktop under VirtualBox — panel, app launcher, graphical Terminal, and real userspace networking (curl okeios.org/helloworld). Same capture as the 28 Jul milestone (illustrated here for the product stack).
Physical monitor showing Okei OS AArch64 boot markers on a Raspberry Pi 5: OKEIOS_AARCH64_FB_BOARD_OK, OKEIOS PI BOARD HDMI CONSOLE, DTB_OK, VIRTIO_NONE, NO_USER
9 August 2026 — first Raspberry Pi 5 hardware boot. HDMI text console from the firmware mailbox framebuffer: OKEIOS_AARCH64_FB_BOARD_OK and OKEIOS PI BOARD HDMI CONSOLE. Kernel EL1 + DTB probe live; virtio absent (expected on board); userspace still NO_USER until microSD root lands.

Kernel

Monolithic ring-0 core: scheduling, 4-level paging, Ext4 VFS, PTY, in-kernel TCP/IP, ptrace, AHCI/NVMe. Multiboot2 on QEMU, VirtualBox, and the web emulator.

Userspace tools

Upstream ports — GNU Bash 5.2, Vim, coreutils, grep, sed, find, bc, curl, wget, Dropbear (+ scp), strace, freestanding git and OpenSSH client, tmux — plus okeios-box (103 applets) and opt-in PIE bash-dyn. Product /bin/bash stays static.

Okei Desktop v1

Display server, panel, Start menu, 21 registered apps (Terminal, Notepad, Calculator, Chess, Solitaire, Asteroids, Settings, and more). Title-close and QEMU click-path gates on shipped apps.

Quality gates

5,357 host unit-test definitions plus QEMU/VirtualBox smokes for net, storage, desktop, multicall, git, and SSH. Not every suite is re-run for each site edit.

Technical overview

3552
git commits
3491
first-party files
510k
lines of code
5357
host unit tests
103
multicall applets
102
system calls

First-party scope matches scripts/marketing_metrics.sh (15 Aug 2026): kernel, boot, userspace, tests, scripts, GRUB, image config — not vendored third-party trees. Growth track: 1,369 files / 292k LOC (23 Jul) → 2,075 / 342k (28 Jul) → 2,450 / 397k (4 Aug) → 2,827 / 434k (6 Aug) → 2,954 / ~450k (9 Aug) → 3,033 / ~459k (14 Aug) → 3,491 / 509,590 now — first time over half a million first-party lines. Syscalls 89 → 102. House-clean (13–15 Aug): 739 commits, +65,666 / −6,491 lines, 1,255 source files touched.

Timeline

Milestones

Reverse chronological. Eyebrow dates are capture or land dates from our private trees — not website-publish dates.

Milestone · 15 August 2026

Half a million first-party lines

The in-tree count crossed 500,000 lines — 509,590 today, in 3,491 files. That is kernel, boot, userspace, tests, scripts, GRUB, and image config. It is not vendored Bash, Vim, or the toolchain. One hundred and eighteen days after the first SlimOS commit (19 Apr), the private tree is a half-million-line operating system we boot ourselves.

How it grew

292k on 23 Jul → 450k on 9 Aug → 459k on 14 Aug → 510k on 15 Aug. About 217k first-party lines in three weeks, then the last 50k in a day of leftover splits and host units.

What the number is

Same find as scripts/marketing_metrics.sh. C, headers, assembly, shell, Python, linker scripts, GRUB/image config. Third-party ports stay out of the total on purpose.

What it is not

Not a finished product, not a public tree, not a claim that 2,411 house-clean findings are fixed. Size is a milestone. Behavior still has to earn each gate.

Alongside

3,552 commits (~30/day). 5,357 host unit-test definitions. 102 syscalls. Pi 5 HDMI boot already landed. House-clean still walking the rest of the tree.

Status · 13–15 August 2026

First-party house-clean: a thousand files on the ledger

Before a public tree, every first-party file is being read by hand. Review commits add contract comments and a ledger row. They do not close the bugs they find. Later host-unit children may wire helpers and can change product policy.

Pace

739 commits since 13 Aug (304 / 327 / 206 on 13–15). 812 H children closed. Parent epic stays open until all 3,491 metrics files have a row.

Read so far

1,038 ledger rows — kernel 714/870, all of userspace/libc, Okei Desktop 230/396. Tests (1,437) and scripts (310) not started.

Catalog

2,411 findings (1,228 contract, 1,101 logic, 82 security) and 2,367 missing-test rows. Filing is not fixing.

Diff

Since 13 Aug: +65,666 / −6,491. Source +53,941 / −4,239 across 1,255 first-party files. Ledger docs are a large share of the rest.

Milestone · 9 August 2026

Raspberry Pi 5 boots with HDMI console

First physical Raspberry Pi 5 (1 GiB) boot of the AArch64 kernel with a real HDMI text console via the VideoCore property mailbox. Capture on a wall monitor shows board markers end-to-end from framebuffer init through DTB and syscall table.

Pi 5 HDMI console: OKEIOS_AARCH64_FB_BOARD_OK and OKEIOS PI BOARD HDMI CONSOLE
Hardware photo — not QEMU. Flashable image okeios-pi5-aarch64.img.

What works

FB_BOARD_OK, HDMI paint, EL1, DTB probe, VBAR/SVC table. Soft virtio correctly reports VIRTIO_NONE.

Next on board

Userspace after NO_USER (1 GiB-safe load + microSD root), debug UART base map, then shell on HDMI.

QEMU path

AArch64 virt bash + interactive CLI remain the daily software gate for the same tree.

Honesty

HDMI console ≠ board shell. SDHCI root and board UART still open task gates.

Milestone · 6 August 2026

HTTPS, scp, git, and desktop click-paths

Closed CA-verified HTTPS (curl + wget), Dropbear scp put/get, freestanding git porcelain, live ssh -X x11-req smoke (protocol path), Vim/PTY/tmux, title-bar close campaign, image PPM+BMP Open/Save, and QEMU click-paths across shipped desktop apps. Product Bash remained static.

Net

Real CA verify; scp session-close green; product /bin/ssh stays Dropbear dbclient.

Git & editors

Guest add/commit/status/diff/log; Vim edit round-trip; Multiboot tmux.

Desktop

File Manager, Calculator, Chess, Solitaire, Task Manager Kill, Calendar, Theme, Network, Asteroids, Font Viewer, Settings — host selftest + QEMU markers.

Scale then

~434k LOC · 4,210 unit tests · 2,827 files · 102 syscalls.

Milestone · 5 August 2026

Shared libc, dyn bash, Bash honesty

PIC newlib as shared libraries, opt-in bash-dyn (guest dyn smoke), DT_GNU_HASH, and honest Bash sleep/getppid/alarm/ttyname paths. Product /bin/bash stayed statically linked. okeios-box at 103 applets.

Milestone · 4 August 2026

Multicall, terminal stability, sparse root, USB HID

okeios-box multicall expansion, terminal stability suite (single finish predicate, FG_EXIT on all zombie deaths), sparse demand Ext4 root, xHCI HID software path, product DNS, gzip Multiboot module.

Milestone · 1 August 2026

Pipeline stability and product tools

Multi-loop Bash pipelines that survive real work; FHS-style PATH; upstream find/bc/kill; product smoke for grep/ps/scp; NVMe root e2e; RO text COW on fork. Footprint then ~366k LOC.

Milestone · 28 July 2026

VirtualBox desktop curls okeios.org

Under Oracle VirtualBox, Okei Desktop Terminal runs curl okeios.org/helloworld and prints the live greeting — DNS, TCP, and HTTP through the in-kernel stack.

VirtualBox Okei Desktop Terminal after curl okeios.org/helloworld
HTTP from a real VM desktop. Captured 28 Jul 2026.
Milestone · 27 July 2026

Self-SSH, ~16s desktop path, strace, NVMe

Guest self-SSH over loopback TCP, VirtualBox GUI path cut to ~16 s to Terminal (lab bench), upstream strace 6.9 on real ptrace, PCIe NVMe driver.

Milestone · 23 July 2026

VirtualBox boots and pings the Internet

Same Multiboot2 ISO under VirtualBox reaches interactive Bash; guest ping google.com receives a public ICMP reply.

VirtualBox guest bash after ping google.com
Real networking from a VM. Captured 23 Jul 2026.
Milestone · 11 July 2026

Bash in a web x86_64 emulator

Real Multiboot2 kernel and userspace reach interactive bash-5.2# in a custom browser emulator (sibling okeios-web) — not v86, not QEMU-in-WASM.

Okei OS web emulator at bash-5.2#
Interactive Bash in the browser. Captured 11 Jul 2026.
Milestone · 26 June 2026

Okei Desktop in QEMU

Terminal, Chess, and the desktop panel together — Desktop v1 visual from a private make all image.

Okei Desktop with Terminal and Chess in QEMU
Okei Desktop v1 — panel, Terminal, Chess. Captured 26 Jun 2026.
Milestone · 21 June 2026

Project renamed to Okei OS

Codebase and product language standardized on Okei OS and Okei Windows (desktop). Public and marketing names use Okei Desktop for the GUI; source trees keep the okeiwin prefix as an implementation detail.

Milestone · 21 April 2026

First ISO build and QEMU boot loop

Within days of the repository starting, the tree produced a bootable ISO and launched QEMU. Same-day work fixed Multiboot long-mode entry, page-directory layout, and identity-mapped kernel paging — the “getting code working” phase.

Host building ISO while QEMU shows early boot serial
First working boot loop. Host finishes the ISO build; QEMU shows SeaBIOS and early kernel serial. Captured 21 Apr 2026 ~19:00.
Milestone · 19 April 2026

Git history begins

First commit on master: project scaffolding, Multiboot2 stubs, GDT/IDT, VGA/serial, page allocator, scheduler sketch, VFS notes, Makefile/QEMU, and phased task tracking. Project age is counted from this commit.

Honest status. Okei OS is private pre-alpha — not a download, not open source yet. What “works” is what we verify with builds, QEMU gates, VirtualBox boots, and the web emulator. The house-clean is a read-and-file campaign plus host-unit extracts — not a claim that 2,411 findings are fixed. Pi 5 board userspace, headed Terminal outbound SSH polish, and remote X PRESENT remain lab residuals. Optimistic about a public open-source release soon; no hard calendar date.
Basics

What is an operating system?

An operating system is the brain and nervous system of a computer — the software that wakes up the hardware, manages memory, talks to display and keyboard, and gives applications a safe place to run. Building one from scratch means owning every layer of that story.

Direction

Where we are headed

Near-term: installable pre-GUI release — reproducible build/install, newlib sysroot, Bash as the interactive shell, real userspace networking, PTY substrate — then deeper GUI polish. Longer term: local-first tooling and creator workflows.

Productivity & Office

Browser, email, notes, documents, spreadsheets — on the Horizon map, not built today.

Creator's Suite

Page design, image/video, CAD-style tools for makers.

On-device AI

Local intelligence without cloud dependency.

Aether windowing

Capability-secure remote surfaces over the network.

Horizon map

FAQ

Common questions

What is Okei OS?

A from-scratch 64-bit OS with a custom kernel, GNU Bash, upstream utility ports, and Okei Desktop v1. Private pre-alpha — we boot it in QEMU, VirtualBox, and a browser emulator.

Can I download or run it?

Not yet. No public repository, ISO, or hosted emulator. A public open-source release is a near-term goal without a fixed ship date.

Is there a web browser or office suite?

No. Those categories are on the Horizon — direction only.

Where is the technical truth?

The OS page has architecture, boot path, ports, and known gaps — still our private tree, not a public binary.

Open source · soon

Availability

Okei OS is not public yet — no open repository, no downloadable ISO, no hosted emulator for visitors. We are preparing an open-source release and are optimistic it can go public soon, once build, test, and contribution workflows are solid enough to invite others in.