In-house product · Operating system

We built an operating system around Claude.

LeafdeckOS is our own Linux operating system, and Claude shapes it around the person using it. Connect a Claude Pro or Max account, describe how you work, and Claude builds the apps, layouts, and routines you need right into the desktop. Your data stays on your machine.

LeafdeckOS logo
Type
In-house product
We built
OS image, Chromium desktop, apps
Runs on
64-bit Intel and AMD PCs
Status
In development, private beta first
Product site
leafdeckos.com (opens in a new tab)
Written by
Andrew Byrd, founder
Why we built it

On every other OS, Claude is a guest.

Windows and macOS are made for everyone, so nobody gets exactly what they need. Claude sits on top of them as a chat box in a corner, and it only sees what you paste in. We wanted one computer where Claude is part of the system: it can see your windows, work in your files and apps, and build the tool you're missing instead of waiting for someone to sell it.

So we built the whole stack: the operating system image, the desktop, and the apps on top of it. It runs on your own Claude plan through Claude Code, with no API key, no Leafdeck account, and no server in the middle.

What makes it different

A Chromium desktop, so Claude reads the screen instead of guessing.

On Windows, macOS, or a standard Linux desktop like GNOME or KDE, every app draws its own window its own way, and Wayland rightly stops one program from reading another. An AI assistant there has to work from screenshots: take one, guess where to click, take another.

LeafdeckOS is built differently. Nearly everything on screen belongs to one Chromium app, and Chromium already describes every window to screen readers. Claude reads that same description through Chromium's own debugger: every button, field, and line of text, each with an ID it can click. Because it reaches it from inside Leafdeck, nothing gets around Wayland's rules.

  • Better control. Claude clicks the exact button by its ID instead of estimating coordinates from a picture.
  • Faster. No screenshot after every step, so a task takes a few quick reads instead of a long loop of looking and guessing.
  • More efficient. Text is far cheaper than images, so the same work uses a fraction of your plan.

Regular Linux apps from Flathub still work. They're drawn by GTK or Qt, so for those Claude falls back to screenshots, like anywhere else.

~2ktokens to change the main screen on LeafdeckOS, versus about 16,000 through screenshots
~85%less plan usage operating apps and Settings
~80%less reading your calendar, tasks, and invoices
4levels of control, from suggestions to the whole desktop

Estimates, compared with a screenshot-based computer-use tool on Windows or macOS.

What Claude can do

Real work, on a real computer.

Desktop control

Claude can see and use the windows you allow.

Turn on Claude Code control and Claude gets tools built into the OS: list the open windows, read any of them as an outline, click, type, scroll, and take screenshots. That covers websites and Settings too. A badge in the menu bar shows when it's working.

App Builder

Describe a tool, and it shows up in the Dock.

Claude writes the app, opens it, and checks its own work with screenshots. Each app runs in its own sandbox, asks before using your data, and saves a version before every change so you can restore it in one click.

Design tools

Design it, then hand it to Claude.

Designer captures any element from any window, with its hover, focus, and pressed states, as editable layers. One button writes the hand-off for HTML and CSS, React, React and Tailwind, Vue, Svelte, a web component, or a LeafdeckOS app. Graphic Designer handles vector artwork.

Back office

Clients, money, and time on one desktop.

Clients, Pipeline, Invoices, Time Tracker, Finance, Calendar, and Tasks, with widgets for inboxes, the agenda, today's tasks, and the timer. Claude reads all of it directly as data when you ask a question.

Workflows

Close the lid. Claude keeps working.

Terminals and Claude sessions run in a system service, not inside a window. Restart the desktop and the work is still going, with its output intact. Claude can set up and run the routines you repeat.

Control

Four levels, and you pick one.

Suggestions only, ask before each step, work only on the apps it builds for you, or operate the whole desktop. You can step back down at any time, and anything that needs administrator rights still asks for your password.


In daily use

One person, three jobs, one computer.

LeafdeckOS is my everyday computer. I'm a designer, a developer, and a business owner, often in the same hour, and nothing off the shelf fit all three. So I asked Claude to build the environment I needed, piece by piece.

It runs on a Lenovo Yoga Book 9: two touch screens and an external monitor, hardware Linux barely supported. Claude got the speakers working, made touch follow each screen, and wired up the function keys the system ignored. The OS fits the machine, not the other way around.

Under the hood

Fedora underneath. Chromium on top.

  • Its own Linux distribution. Built from Fedora's image-based system (bootc). The whole system updates as one image, and if an update doesn't boot, it rolls back. Fedora handles the kernel, drivers, sound, and networking.
  • One app is the whole desktop. An Electron app (Chromium plus Node.js) replaces GNOME or KDE: the Dock, menus, Settings, the work apps, and every website.
  • A display layer that does one job. cage, a minimal Wayland compositor, patched for program windows, touch, and rotation. Flatpaks from Flathub open as real Wayland windows inside Leafdeck's frames.
  • Desktop tools for Claude Code. A local MCP server gives Claude the tools to list, read, click, fill, and screenshot windows. Only this computer can connect, and it switches off in Settings.
  • A background service that outlives the UI. A systemd service keeps terminals and Claude sessions running when the desktop restarts.
  • Local first. Data lives in SQLite on your own disk, with no account and no server. Export everything to one encrypted file to move computers.
ElectronChromiumFedora bootccageWaylandsystemdPipeWireSQLiteFlatpakClaude CodeMCP
What it means for you

If we can build an OS, we can build your software.

LeafdeckOS covers most of what we offer clients: a CRM, invoicing, sandboxed apps, design-to-code tooling, and AI that works with your real data instead of screenshots of it. When your project needs one of those, we've already built it once for ourselves.

Let's talk

Want something like this for your business?

Tell us what you're trying to build. We'll show you how we'd approach it.