Reference
Capability catalog
Every native action OOMU can take, by identifier.
A capability is the unit of action in OOMU. Each one has a fixed identifier, an input schema, an output schema, a native executor, and a postcondition verifier. The router may only propose capabilities that exist in the manifest for the current build, and execution may only run what the router proposed.
There is no generic "run a command" capability. If an action is not in this catalog, OOMU cannot take it.
Dump the live manifest for a specific build with
--dump-capabilities.
Files
| Capability | Action |
|---|---|
files.read | Read a file. 2 MB default, 16 MB maximum. |
files.list | List a folder. 2,000 entries default, 10,000 maximum. |
files.write | Write a file. 16 MB maximum. |
files.move | Move a file. |
files.trash | Move a file to the Trash. Reversible. |
files.delete_permanently | Permanently delete a file. Irreversible. |
Apple apps
| Capability | Action |
|---|---|
apple.mail.read | Read mail |
apple.mail.draft | Create a mail draft |
apple.mail.send | Send mail |
apple.mail.delete | Delete a mail message |
apple.notes.read | Read notes |
apple.notes.create | Create a note |
apple.notes.update | Update a note |
apple.notes.delete | Delete a note |
apple.reminders.read | Read reminders |
apple.reminders.create | Create a reminder |
apple.reminders.complete | Complete a reminder |
apple.reminders.delete | Delete a reminder |
apple.contacts.read | Read contacts |
apple.contacts.lookup | Look up specific contacts, returning a bounded set of fields |
apple.contacts.create | Create a contact |
apple.photos.read | Read Photos |
apple.photos.create_album | Create a Photos album |
apple.music.read | Read Music status |
apple.music.play | Play music |
apple.music.pause | Pause Music |
apple.notification.deliver | Deliver a notification |
apple.calendar.read | Read Calendar events |
apple.calendar.create | Create a Calendar event |
apple.shortcuts.list | List the Apple Shortcuts installed for this user |
apple.shortcuts.run | Run one installed shortcut with optional text or file input |
apple.system.get_clipboard | Read the current text from the clipboard |
apple.system.set_clipboard | Copy exact text or one deliverable file to the clipboard |
All of these are governed by macOS TCC and Automation permissions.
Applications
| Capability | Action |
|---|---|
app.macos.list | List installed applications, with bundle identity and running state |
app.macos.launch | Open an application, or bring it forward |
app.macos.activate | Bring an application to the front |
app.macos.hide | Hide a running application |
app.macos.quit | Ask a running application to quit normally |
Browser
| Capability | Action |
|---|---|
browser.visible.navigate | Navigate the contained browser to a page |
browser.dom.observe | Take a fresh snapshot of the page |
browser.dom.screenshot | Capture the page |
browser.dom.click | Click a snapshot element |
browser.dom.type | Type into a snapshot element |
browser.dom.select | Select a value |
browser.dom.key | Press a key |
browser.dom.submit | Submit a form |
browser.dom.scroll | Scroll |
Every action names an element from a snapshot. There is no capability to evaluate arbitrary JavaScript.
Screen actions
| Capability | Action |
|---|---|
computer.observe | Read the current accessibility state |
computer.focus | Focus an observed element |
computer.press | Press an observed element |
computer.select | Select a value |
computer.key | Press a key |
computer.type | Type text |
computer.submit | Submit |
computer.scroll | Scroll an observed element |
computer.drag_drop | Drag an observed element |
computer.menu | Operate a menu |
computer.upload | Supply a file to an upload control |
Each action carries the observation identifier and element identity it was resolved against. A stale reference fails.
Google Workspace
| Capability | Action |
|---|---|
google.gmail.list_messages | List Gmail messages |
google.gmail.read_thread | Read a Gmail thread |
google.gmail.draft_message | Create a Gmail draft |
google.gmail.send_message | Send a Gmail draft |
google.calendar.list_events | List Calendar events |
google.calendar.create_event | Create a Calendar event |
google.drive.search | Search Drive |
google.drive.read_file | Read a Drive file |
Backed by the gmail.modify, calendar.events, and drive.readonly scopes.
Connected services and tools
| Capability | Action |
|---|---|
connector.remote.operation.invoke_read | Read from a connected service |
connector.remote.operation.invoke_write | Update a connected service |
mcp.remote.tool.invoke_read | Read with a connected tool |
mcp.remote.tool.invoke_write | Make a change with a connected tool |
mcp.local.tools.list | List local tools |
mcp.local.tool.invoke_read | Read with a local tool |
mcp.local.tool.invoke_mutation | Run a local tool that makes changes |
channel.remote.message.send | Send a message to a verified messaging channel |
Documents
| Capability | Action |
|---|---|
artifacts.create | Create a document |
artifacts.export | Export a document |
artifacts.inspect | Inspect a document and produce a preview |
deliverables.export_executive_docx | Export a structured Word document |
deliverables.export_financial_xlsx | Export an Excel workbook with verified formulas |
document.local.query_section | Read a section of an indexed document |
document.project.query | Answer a question across a project's indexed documents, bound to cited passages |
document.project.generate_vendor_comparison_matrix | Compare two to five project documents and build an evidence-bound matrix |
artifacts.inspect is registered but product-only: OOMU calls it to build a preview, and it is never offered to the model as a selectable action.
Projects and memory
| Capability | Action |
|---|---|
project.scratchpad.read | Read the project's Notes |
project.scratchpad.append | Add to the project's Notes |
memory.internal.read | Read saved memories |
memory.internal.remember | Save a memory |
memory.internal.forget | Forget a memory |
Memories are scoped global or project, up to 16,000 bytes each.
Mods
| Capability | Action |
|---|---|
mods.asset.read | Read a declared knowledge file from a Mod |
mods.state.read | Read a Mod's declared state keys |
mods.state.replace | Write a Mod's declared state keys |
The entire Mod surface. See the Mod package specification.
Web and system
| Capability | Action |
|---|---|
web.public.retrieve | Run one public web search and return its results. DuckDuckGo Lite over direct HTTPS first, headless Brave Search second. Never displays a browser |
web.public.research | The multi-source research executor. Still registered for its existing callers; ordinary chat and @Search both use web.public.retrieve |
workflows.scheduled.create | Create a scheduled workflow |
system.runtime_status | Report OOMU's own runtime state |
system.registered_tool.run | Run a registered tool |
code.apply_patch | Apply an exact code patch |
oomu.quick_launcher.calculate | Evaluate a calculation natively, in exact decimal arithmetic |
Navigation
Product-only capabilities that open a destination in the interface. These are registered but not offered to the model as selectable actions.
| Capability | Opens |
|---|---|
app.chat.open | Chat |
app.projects.open | Projects |
app.workflows.open | Workflows |
app.artifacts.open | Documents |
app.connections.open | Connections |
app.mods.open | Mods |
app.profile.open | Profile |
app.settings.open | Settings |
Availability
A capability being in this catalog does not mean it is usable right now. Three things gate it:
| Gate | Effect |
|---|---|
| macOS permission | Apple, screen, and file capabilities require the relevant TCC grant. See Settings → Mac access. |
| Connection state | Google, connector, MCP, and channel capabilities require a live connection. |
| Air-Gap Mode | Blocks every capability that touches the network. |
The router receives the current availability in its turn snapshot, so it does not propose an action that cannot run.
Available in the workflow builder
Only four capabilities are currently exposed as authored workflow steps: system.runtime_status, web.public.retrieve, files.list, and artifacts.create. See Building workflows.
Related
- Automating your Mac: these capabilities in practice.
- Evidence & receipts: what every execution records.
- Application Bridge API: the command layer above this.