GitHub - hansstam86/wibeos

A fully hallucinated operating system for macOS, inspired by Steve Sanderson's vibeOS from BUILD 2026.

The desktop shell is real and local (menu bar, dock, draggable windows, menus — all instant, zero API calls). The apps are not: each app window is hallucinated by Claude as a self-contained interactive HTML mini-app running in a sandboxed iframe. Claude writes working JavaScript on the fly, so a calculator actually computes locally; only actions that need fresh imagination (navigating the fake the Jungle browser, etc.) trigger a regeneration. Opened apps are cached, so reopening is instant.

What's new

• Mission Control — Ctrl+↑ (or Window → Mission Control) tiles every open window into a zoomable overview; click a tile to focus it, Esc to dismiss. The live iframes keep running while tiled — nothing is re-hallucinated.
• Desktop clock widget — a live clock/date widget sits on the desktop and ticks every second, styled to match the persona's theme.
• Screenshot — Cmd+Shift+3 snapshots the current screen (via WKWebView.takeSnapshot), pings you with a notification, and opens a Save panel to export the PNG out to reality. Apps can also call wibe.screenshot() from the bridge.
• Nine new hallucinated apps in the App Store catalog: Weather, World Clock, Calendar, Maps, Stocks, Voice Memos, Paint, Stickies, and Arcade — each invented per-persona on first open like everything else.

Requirements

• macOS 13+
• Swift toolchain (Xcode or Command Line Tools: xcode-select --install)
• An Anthropic API key (https://console.anthropic.com)

Run

make run          # build & launch
make app          # build WibeOS.app, then: open WibeOS.app

On first launch it asks for your API key (stored in the app's preferences; or set ANTHROPIC_API_KEY in the environment instead).

OS services

• wibe.fs — a real persistent file system, per persona: save a note in Notes, find it in Finder, open it in TextEdit. Survives reboots.
• Launchpad — the dock keeps only the Core 6 (Finder, Jungle, Notes, Mail, Messages, Settings) to stay uncluttered; the 🚀 dock icon (or F4) opens a full-screen App Dashboard with every app — core, App Store, and installed — plus a type-to-filter box. Click an icon to launch and close.
• Spotlight — Cmd+K (or 🔍 in the menu bar): launch any app, open any file, or imagine anything on the spot.
• Notifications — apps call wibe.notify(), and every few minutes the persona's world pings them on its own (emails, reminders, in-character events). Click a toast to open the relevant app.
• wibe.ai — apps can call Claude at runtime, so chatbots actually chat and fortune tellers actually divine.

App Store & themes

The dock has an App Store stocked entirely with apps invented for whoever is logged in — Get installs them to the dock permanently (per persona; right-click a dock icon to remove). On first login each persona also gets a full OS theme hallucinated for them — wallpaper, accent, menu bar, dock, window chrome, fonts — and apps are told the accent/dark-mode so they match.

Personas

Boot lands on a login screen. Who you log in as changes everything: the persona is injected into every hallucination, so Grandma's Mail is chain letters in giant fonts while the hacker kid's whole machine is neon-on-black 1998. Each persona gets its own app cache. Click + to invent new personas ("a medieval wizard discovering computers"); right-click an avatar to remove it. Log out via the menu.

Use

• Click dock icons to "launch" apps — you watch the HTML stream by as Claude hallucinates the app, then it becomes real(ish). Click ✨ to imagine any app.
• Option-click a dock icon (or View → Re-imagine) to force a fresh hallucination instead of the cached version.
• Menu bar, window dragging/minimize/zoom, Cmd+W close — all local and instant.
• Ctrl+↑ Mission Control, F4 Launchpad, Cmd+Shift+3 screenshot, Cmd+K Spotlight.
• Cmd+R reboots. Cmd+Ctrl+F for full screen — recommended for the illusion.
• Right-click → Inspect Element works for debugging the generated HTML.
• Camera/photo-booth apps use your real webcam (macOS will ask once). For the permission prompt to be attributed correctly, run as a bundle: make app then open WibeOS.app — with make run the prompt belongs to your terminal.

Speed

• Persistent cache: each app is hallucinated once, then stored in ~/Library/Application Support/wibeOS/cache — reopening is instant, even across reboots. Option-click a dock icon or View → Re-imagine to regenerate.
• Prefetch: at boot, the core demo dock apps are pre-hallucinated in the background (2 at a time), so most apps are ready before you click. The newer App Store apps (Weather, Maps, Arcade, …) generate lazily on first open so prefetch cost stays flat. Disable with WIBEOS_PREFETCH=0 (first boot prefetch costs roughly 8 app generations).
• Patch updates: data-wibe actions (browser navigation, opening an email…) return only the changed region as <wibe-patch select="…"> blocks instead of the whole app — a fraction of the tokens, applied live without remounting.
• Prompt caching: the system prompt is cached server-side across calls.
• Model: defaults to claude-haiku-4-5-20251001 (fast). For fancier apps: WIBEOS_MODEL=claude-sonnet-4-6 make run.

Tuning

• System prompt: edit systemPrompt in Sources/WibeOS/AppDelegate.swift to change the OS's personality, default dock, look, etc.

How it works

open app ─▶ shell asks Claude for ONE self-contained HTML app (streamed)
         ─▶ injected bridge script added, mounted in sandboxed <iframe>
         ─▶ app runs locally (its own JS) — most clicks cost nothing
         ─▶ controls marked data-wibe / data-wibe-enter round-trip to Claude
            for fresh hallucinated content (whole-window re-render)

Each window keeps its own small conversation history (creation pair + last 6 messages), so updates stay consistent and cheap. The Swift layer is a stateless streaming proxy to the Anthropic API.

Only app generation and data-wibe actions cost tokens; everything else is local.