Documentation
Documentation
Everything you need to install OOMU, build with it, and understand how it works, organized into four clear zones.
Welcome to OOMU; a private, elegant AI workstation that runs on your Mac. OOMU keeps your work on your own machine, draws on the cloud only when a task truly needs it, and can now do far more than answer questions: it organises your work into Projects, runs and tracks real Tasks, works on a schedule as Routines, produces polished Documents, connects to your work apps and messaging channels, and extends through safe Mods; all behind one enforceable trust boundary.
This documentation is organised into four clear zones so you can always find what you need:
| Zone | For | Start here |
|---|---|---|
| Tutorials | Getting up and running | Installation & Your First Launch |
| How-to Guides | Solving a specific task | Scheduling Routines · Generating Documents |
| Reference | Looking up an exact detail | Application Bridge API |
| Explanation | Understanding the design | Privacy & Sandboxing |
Getting your bearings; the six doors
OOMU's sidebar has six destinations, plus Settings and the Ledger in the footer:
| Door | What it's for |
|---|---|
| Chat | Home. Talk to OOMU; pick a starter card to see it work. |
| Projects | A workspace boundary; folders, knowledge, instructions, memory, and a data policy. |
| Tasks | Everything OOMU is doing, has scheduled, or can run as a workflow. Three sections: Now, Scheduled, Workflows. |
| Documents | The Word, PDF, Excel, and PowerPoint files OOMU produces, with previews and provenance. |
| Connections | Connect your work apps (Google Workspace, Slack, Microsoft 365) and your messaging channels (Signal, Telegram, WhatsApp, Discord). |
| Mods | Install and manage .oomu capability packages. |
Assistants ("agents") are reached from the agent control in the Chat header rather than a rail item.
Tutorials; step by step
- Installation & Your First Launch: From download to a working workspace, guided setup, and your first result.
- Setting Up a Project: Create a workspace that scopes folders, knowledge, memory, and cloud policy.
- Setting Up Custom Assistants: Create a named assistant and tune how deeply it thinks.
- Adding Custom Capabilities: Install your first
.oomucapability package safely.
How-to Guides; practical recipes
- Scheduling Routines: Have OOMU do recurring work on a schedule and deliver results to your phone.
- Connecting Services: Connect work apps and messaging channels, safely and per-project.
- Generating Documents: Produce verified Word, PDF, Excel, and PowerPoint files.
- Automating Your Mac: Guarded browser and macOS app automation, with takeover.
- Working Remotely: Delegate, steer, and approve work from your phone.
- Building Automated Workflows: Compose multi-step workflows in plain language.
- Building a Custom Capability Package: A developer's guide to packaging a
.oomumod. - Smart Model Routing: Balance speed, cost, and intelligence with Auto-Route and web grounding.
- Enterprise Administration & Security: Signed capability bundles, the curated registry, and managed policy.
Reference; technical specifications
- Capability Package Specification: The
.oomuarchive,manifest.json, and signed bundle format. - Application Bridge API: The command layer between the interface and the desktop engine.
- Local Database Schema: The encrypted SQLite tables OOMU stores on disk.
Explanation; design & philosophy
- System Design Overview: How OOMU runs on your desktop.
- The Delegated-Work Loop: Projects, Tasks, evidence, and how OOMU proves what it did.
- Privacy & Sandboxing: How your data stays protected.
- Hybrid AI Economics: The power of local and cloud working together.
Status: Written against the current OOMU codebase (Tauri 2 + Next.js desktop application), covering the P0 "sovereign Mac coworker" release and the P1 expansion (Microsoft 365, office artifacts, computer use, multimodal, remote dispatch, capability bundles, and adaptive learning). Where a capability is gated or build-dependent, the page says so.