Documentation

OOMU is a private AI workspace that runs on your Mac. A small model trained by us reads every request and decides whether it can be answered on this Mac or genuinely needs the cloud. Most of the time the answer is your Mac, and nothing leaves it.

This documentation covers OOMU Beta 2: a ground-up rebuild. If you used Beta 1, read What changed in Beta 2 below before anything else.

---

Finding your way around

The sidebar has four destinations, with On this Mac and Settings below them:

Two things live outside the window: the Quick Launcher (⌘⇧Space from anywhere) and the quick switcher (⌘K inside OOMU).

---

Tutorials

• Installation & first launch: From the download to a working workspace, including the guided model setup.
• Setting up a project: Keep a case or client together, with its own files, notes, instructions, and cloud policy.
• Creating an agent: Give OOMU a named role with its own instructions, personality, and model.
• Installing a Mod: Add an .oomu package and understand what its trust badge means.

How-to guides

• Working fast: The Quick Launcher, quick actions, and the quick switcher.
• Connecting services: Apple apps, Google Workspace, cloud models, local tools, and messaging channels.
• Analyzing documents: Ask questions across a pile of files and compare contracts, all on this Mac.
• Generating documents: Produce Word, Excel, PowerPoint, and PDF files that OOMU reopens to check.
• Automating your Mac: Apple apps, application control, the built-in browser, and screen actions.
• Building workflows: Save a sequence of steps and run it on demand.
• Scheduling routines: Run a saved workflow on a schedule, including after OOMU closes.
• Choosing a local model: Add your own models and read what your Mac can actually do.
• How OOMU picks a model: Automatic, On this Mac, and Cloud, and the router behind them.
• Enterprise security: Air-Gap Mode and the hardware-signed audit ledger.
• Building a Mod: A developer's guide to packaging an .oomu file.

Reference

• Capability catalog: Every native action OOMU can take, by identifier.
• Mod package specification: The .oomu archive, manifest.json, and the Beta 2 ABI.
• Application Bridge API: The command layer between the interface and the native engine.
• Local database schema: The encrypted SQLite tables on your disk.

Explanation

• System design overview: How a request travels from your keyboard to a verified result.
• Evidence & receipts: Why OOMU distinguishes what a model said from what actually happened.
• Privacy & security: Where your data lives and who governs access to it.
• Hybrid AI economics: Why local and cloud together beats either one alone.

---

What changed in Beta 2

Beta 2 is not an update to Beta 1. It is a new application with a new bundle identifier (ai.eldris.oomu.gpd.beta2), its own database, and its own Keychain namespace. It does not read Beta 1 data, though it can import a Beta 1 agent from a file.

The largest change is philosophical. Beta 1 built its own permission system on top of macOS: a file sandbox, a permission broker, trust policies with budgets, and a capability gatekeeper. Beta 2 removes all of it and defers to the operating system for access to your machine, where every native macOS permission is enforced. When OOMU needs your Calendar, macOS asks, once, in its own voice, and you manage it in System Settings like every other app. What leaves your machine is still OOMU's decision, gated in the engine.

New in Beta 2: the Quick Launcher on ⌘⇧Space, quick actions that turn pasted text into finished documents, twenty-seven Apple app actions and a menu bar item, Ask Documents and document comparison, Air-Gap Mode and a Secure Enclave-signed audit ledger, a PowerPoint engine, and full parity across twelve languages.

---

Status. Written against OOMU 0.2.0, the Beta 2 (Apocalyptic Captain) public release for macOS 14 and later on Apple Silicon. Where something is gated by how your copy was built, or is not finished, the page says so rather than implying otherwise.