Skip to content
View 0xmortuex's full-sized avatar

Highlights

  • Pro

Block or report 0xmortuex

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please donโ€™t include any personal information such as legal names or email addresses. This note will only be visible to you.
Report abuse

Contact GitHub support about this userโ€™s behavior. Learn more about reporting abuse.

Report abuse
0xmortuex/README.md
Fadi (0xmortuex), 10th grade, Istanbul. I build the whole stack, compiler to agent: a language (Mort), an OS written in it (MORT OS), a TCP/IP stack for it (mortnet), and 13 MCP servers that let AI agents boot, debug and read hardware.

ฮป Mort ย ยทย  ๐Ÿ’พ MORT OS ย ยทย  ๐Ÿค– OSdev MCP servers ย ยทย  โฌ‡ Vex ย ยทย  โšก FlashMind ย ยทย  ๐Ÿ“š Guides


1 language written from scratch, 1 operating system that boots real PCs, 13 MCP servers for OS-dev agents, 40+ Claude Code skills, 7 from-scratch guides.

๐Ÿ†• What's new

๐Ÿค– A fleet of OSdev MCP servers 13 servers that let AI agents boot kernels in QEMU, rewind them, single-step them over the gdbstub, and decode ACPI tables, devicetrees, page tables and linker maps โ€” jump to them โ†“
๐Ÿ’พ MORT OS grew up Users, permissions and sudo, a hierarchical MortFS v2, a home launcher and Settings app, a power menu with lock / sleep / restart / shutdown, and a live RTC clock
๐Ÿ“š "The hard way" guides Build a TCP/IP stack, a kernel gdbstub, ACPI support, and an MCP server from an empty file โ€” every chapter verified in real QEMU
๐ŸŒ Vex profiles & import Side-by-side profiles with their own tabs, passwords and sync, plus importing from Chrome, Edge, Brave and Firefox
โšก FlashMind lecture mode Record a lecture in class and get a live transcript turned into notes, cards and exam alerts
๐Ÿ“ฐ ai-news-tracker Rebuilt as a serverless pipeline: a scheduled Action ingests ~75 sources, dedupes and clusters stories, and publishes JSON + Atom feeds that the Vex start page reads

ฮป The Mort stack โ€” a language, then an OS written in it

I wanted to know what's underneath, so I built Mort โ€” a statically-typed language whose whole compiler (lexer, parser, type checker, C code generator) is written from scratch in Python with zero libraries. Then I wrote MORT OS in it. Mort compiles to C instead of being interpreted for one reason: an interpreter can't boot.

CI tests kernel license

Toolchain: hello.mx goes through mortc (my compiler) to freestanding C, then zig cc cross-compiles to i386, producing mortos.iso (Limine BIOS/UEFI) that boots a real PC from a USB stick. Inside the ISO, all in Mort: drivers, MortFS v2, users and sudo, a desktop with apps, the mortnet TCP/IP stack, int 0x80 syscalls.

What MORT OS does today

  • Boots real PCs โ€” Limine BIOS/UEFI ISO, straight from a USB stick
  • Real drivers โ€” PS/2 keyboard, PIT, CMOS clock, ATA disk, framebuffer, RTL8139 NIC
  • A real filesystem โ€” MortFS v2 with directories, owners and Unix permission bits
  • Users & sudo โ€” plus a shell with a working directory, $PATH and env vars
  • A desktop โ€” Terminal, Files, a Vex-styled browser and Settings, on F1โ€“F5
  • Programs โ€” compiled Mort binaries talk to the kernel over int 0x80
  • Networking โ€” net gets an IP over DHCP, httpd serves a web page
// examples/fib.mx
fn fib(n: int) -> int {
    if n < 2 { return n; }
    return fib(n - 1) + fib(n - 2);
}

fn main() -> int {
    let i = 0;
    while i < 10 {
        print(fib(i));
        i = i + 1;
    }
    return 0;
}

MORT OS graphical desktop โ€” the window manager, drivers, filesystem and shell are all written in Mort

MORT OS power menu: Lock, Sleep, Restart, Shut down, with a live clock in the top bar MORT OS networking: net leases 10.0.2.15 over DHCP, httpd serves on port 80

The desktop, the power menu, and httpd serving a page โ€” a web server, on an OS, over a TCP/IP stack, every layer in one language I wrote.

Around the OS

Project What it is
mortnet TCP/IP stack written from scratch in Mort โ€” NIC driver โ†’ ARP โ†’ IPv4 โ†’ ICMP โ†’ UDP โ†’ DHCP โ†’ DNS โ†’ TCP โ†’ HTTP โ€” vendored into MORT OS
MortHardware Reusable bare-metal drivers pulled out of MORT OS: PCI, RTL8139, AC'97 audio, UHCI USB
mort-repo Package registry for mpkg, the MORT OS package manager
nanomort The whole idea in one Python file under 800 lines โ€” a typed language that compiles to C and still boots a kernel

๐Ÿค– AI agents that do OS development

AI agents can edit and build a kernel, but they can't see it boot โ€” and they make up hardware facts. These MCP servers close that gap. Every one works below the OS: no SSH, no guest agent, nothing installed in the guest. They grew out of my own MORT OS dev loop.

13 MCP servers for OS developers. Drive: qemu-mcp, qemu-replay-mcp, gdbstub-mcp, uefi-mcp. Decode: acpi-mcp, devicetree-mcp, pagetable-mcp, linkmap-mcp, x86-ref-mcp. Look up: osdev-wiki-mcp, kconfig-mcp, syzbot-mcp, mort-mcp.
Server It lets an agentโ€ฆ
qemu-mcp โญ boot an ISO or kernel, type, screenshot, read serial
qemu-replay-mcp record a run, step backwards, find who wrote an address
gdbstub-mcp set breakpoints, read registers and backtraces โ€” no gdb binary
uefi-mcp boot an .efi under OVMF and decode EFI_STATUS and GUIDs
acpi-mcp read MADT, FADT, MCFG from a live VM
devicetree-mcp decode and validate .dtb / .dts, memory maps, IRQ routing
pagetable-mcp walk live x86 page tables and explain page faults
linkmap-mcp explain where code landed in a linked binary and why
x86-ref-mcp look up instruction forms, flags, CPUID, CR/MSR bits
kconfig-mcp answer "why can't I enable CONFIG_X?" with file:line
syzbot-mcp fetch and explain syzbot Linux kernel bug reports
osdev-wiki-mcp search the OSDev wiki offline
mort-mcp write, type-check and run Mort โ€” a language it has never seen

MORT OS terminal after an AI agent typed help โ€” captured through qemu-mcp

An AI agent took this screenshot. It booted MORT OS headless, pressed Esc, typed help, and captured the framebuffer through qemu-mcp โ€” four tool calls.



Also for agents

claude-code-skills โ€” 40+ Claude Code skills for the unglamorous work that ships software. Before I add a skill, I check the existing ecosystem and only keep it if no well-known skill already does the job.

ClaudeCode-Brain โ€” turns local Claude Code history into a searchable, backlinked Obsidian vault.


๐Ÿ“š Build it yourself โ€” "the hard way" guides

Tutorials where you start from an empty file and end up with something that really works. Every chapter is taken from code that runs, and every step is checked in real QEMU.

Guide You end up with
Write an OS in your own language A compiler in plain Python, then a kernel in your new language that boots, persists files, and serves a web page
TCP/IP stack the hard way Ethernet frames up to an HTTP server, based on mortnet and checked by golden tests
Kernel gdbstub the hard way A gdbstub inside your own kernel โ€” UART, RSP framing, single-step, int3 breakpoints
ACPI the hard way RSDP, MADT, FADT, shutdown, PCIe ECAM and HPET, from scratch
MCP server the hard way An MCP server that lets an AI debug a kernel, from raw RSP bytes to triple-fault diagnosis
qemu-mcp the hard way qemu-mcp rebuilt module by module โ€” QMP, screenshots, typing, serial, snapshots
Roblox anticheat the hard way A production-grade server-side anticheat, every line explained

๐Ÿงญ Apps I ship

Vex โ€” a browser built for you

A Chromium desktop browser (castLabs Electron, so Widevine DRM works) with a built-in AI agent that can work on your tabs, ad & tracker blocking, one-click Tor, an encrypted password vault with 2FA autofill, sidebar apps, profiles, and a UI you can rearrange to the pixel.

Latest release Downloads

โฌ‡ Download for Windows ยท Self-hosting

Vex website โ€” a browser built just for you; try a look: Firefox, Chrome, Safari, Glass or Classic

FlashMind โ€” the AI study engine I use for school

Paste notes, upload a PDF, snap a photo (OCR in English and Turkish), record a lecture, or just name a topic. FlashMind turns it into notes, a flashcard deck and a Turkish-style exam with AI-graded open questions. Reviews are scheduled by an FSRS-4.5 algorithm I wrote myself. It's vanilla JS, with no framework.

FSRS OCR

โšก Try FlashMind ยท Source

FlashMind โ€” pick a 10th-grade subject and topic, paste text, upload a PDF, or record a lecture


๐Ÿ—‚ More work

๐Ÿ”’ Security & OSINT โ€” 6 projects
Project Description Live
ReconX Domain recon in the browser โ€” DNS, WHOIS, SSL, headers, tech stack, subdomains Demo
PassCrack Password analyzer that simulates real attacks โ€” crack times, patterns, entropy, 100% in-browser Demo
NetMap Visual traceroute โ€” packets hop across an interactive world map Demo
CipherLab 13 ciphers and hashes, each with visual step-by-step breakdowns Demo
CodeLens Paste code, get an AI security audit and a quality report card Demo
ai-proxy Cloudflare Worker that keeps AI API keys out of client code, with streaming passthrough โ€”
๐Ÿค– AI tools โ€” 6 projects
Project Description Live
ai-news-tracker Serverless AI news pipeline โ€” ~75 sources, clustering, scoring, JSON + Atom feeds โ€”
LoopholeMap Paste a regulation, see its loopholes as a severity-ranked D3 graph Demo
AIJudge Describe an argument, get a verdict with legal-style reasoning and shareable ruling cards Demo
TermsTrap Flags data selling, forced arbitration and auto-renewals in any Terms of Service Demo
DebateBot Strongest arguments on both sides, with evidence chains and fallacy detection Demo
LexScope Turns dense legislation into navigable sections with plain-English summaries Demo
๐Ÿ›  Apps, desktop & extensions โ€” 9 projects
Project Description Live
mortuexOS My portfolio as a desktop OS in the browser โ€” boot sequence, windows, terminal, 9 apps Demo
Nexus Process Lasso-style Windows optimizer (WPF) โ€” per-process rules, crash-safe Game Mode, undo for every tweak โ€”
RoSuite Free RoPro alternative for Chrome/Brave โ€” server browser, player info, trade calculator โ€”
Zine Manga reader with a print-zine design language โ€” React 19 + MangaDex โ€”
mun-tracker Mobile-first tracker for 43 Model UN conferences in Turkey Demo
ChatRoom Anonymous real-time chat rooms on a Cloudflare KV backend Demo
BillForge CUSA legislative bill editor with auto-numbering and live preview Demo
MiniOS The browser-OS experiment that grew into mortuexOS Demo
Vencord + plugins My Vencord build: ChatExporter, MessageLoggerEnhanced, InactivityTracker, QuickNotes, RoleMembers and more โ€”
๐ŸŽฎ Fun & data โ€” 3 projects
Project Description Live
TypeRush Typing game with quotes, real code snippets, live WPM and achievements Demo
GitPulse Any GitHub username โ†’ a visual developer profile Demo
steamogames Live Steam player stats โ€” concurrent players, peaks and trends โ€”

๐Ÿงฐ Stack

Mort Python C x86 QEMU MCP JavaScript TypeScript React Electron C# Cloudflare Workers

๐Ÿ“Š Stats

GitHub stats Top languages



contribution snake

No third-party stats services on this page. The cards come from a workflow in this repo, and the banner and diagrams are hand-written SVGs.


Every web project above is open source, and most are live on GitHub Pages. Not sure where to start? Boot MORT OS or try FlashMind.

Pinned Loading

  1. roblox-anticheat-the-hard-way roblox-anticheat-the-hard-way Public

    Build a production-grade, server-side anticheat for Roblox from scratch. Every line explained.

    Lua 3 1

  2. Vex Vex Public

    A browser built for you โ€” fast, private, and rearrangeable to the pixel. An Electron/Chromium desktop browser with vertical or top tabs, tab groups & workspaces, a built-in AI agent, ad/tracker bloโ€ฆ

    JavaScript 3

  3. ai-news-tracker ai-news-tracker Public

    Django app aggregating AI news from 20 RSS sources across the US, China, and research labs - country/source filters, search, read tracking, dark Tailwind UI.

    JavaScript 1

  4. FlashMind FlashMind Public

    AI study engine - turn notes, PDFs, or any topic into study notes, FSRS-scheduled flashcards, and Turkish-style exams, with an AI tutor and device sync. Free, no signup, runs in the browser.

    JavaScript 1 1

  5. forge forge Public

    TypeScript

  6. Mort Mort Public

    A statically-typed language that compiles to C, written from scratch in Python โ€” plus MORT OS, a bootable kernel written in Mort.

    Python