← All documentation

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

CapabilityAction
files.readRead a file. 2 MB default, 16 MB maximum.
files.listList a folder. 2,000 entries default, 10,000 maximum.
files.writeWrite a file. 16 MB maximum.
files.moveMove a file.
files.trashMove a file to the Trash. Reversible.
files.delete_permanentlyPermanently delete a file. Irreversible.

Apple apps

CapabilityAction
apple.mail.readRead mail
apple.mail.draftCreate a mail draft
apple.mail.sendSend mail
apple.mail.deleteDelete a mail message
apple.notes.readRead notes
apple.notes.createCreate a note
apple.notes.updateUpdate a note
apple.notes.deleteDelete a note
apple.reminders.readRead reminders
apple.reminders.createCreate a reminder
apple.reminders.completeComplete a reminder
apple.reminders.deleteDelete a reminder
apple.contacts.readRead contacts
apple.contacts.lookupLook up specific contacts, returning a bounded set of fields
apple.contacts.createCreate a contact
apple.photos.readRead Photos
apple.photos.create_albumCreate a Photos album
apple.music.readRead Music status
apple.music.playPlay music
apple.music.pausePause Music
apple.notification.deliverDeliver a notification
apple.calendar.readRead Calendar events
apple.calendar.createCreate a Calendar event
apple.shortcuts.listList the Apple Shortcuts installed for this user
apple.shortcuts.runRun one installed shortcut with optional text or file input
apple.system.get_clipboardRead the current text from the clipboard
apple.system.set_clipboardCopy exact text or one deliverable file to the clipboard

All of these are governed by macOS TCC and Automation permissions.


Applications

CapabilityAction
app.macos.listList installed applications, with bundle identity and running state
app.macos.launchOpen an application, or bring it forward
app.macos.activateBring an application to the front
app.macos.hideHide a running application
app.macos.quitAsk a running application to quit normally

Browser

CapabilityAction
browser.visible.navigateNavigate the contained browser to a page
browser.dom.observeTake a fresh snapshot of the page
browser.dom.screenshotCapture the page
browser.dom.clickClick a snapshot element
browser.dom.typeType into a snapshot element
browser.dom.selectSelect a value
browser.dom.keyPress a key
browser.dom.submitSubmit a form
browser.dom.scrollScroll

Every action names an element from a snapshot. There is no capability to evaluate arbitrary JavaScript.


Screen actions

CapabilityAction
computer.observeRead the current accessibility state
computer.focusFocus an observed element
computer.pressPress an observed element
computer.selectSelect a value
computer.keyPress a key
computer.typeType text
computer.submitSubmit
computer.scrollScroll an observed element
computer.drag_dropDrag an observed element
computer.menuOperate a menu
computer.uploadSupply 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

CapabilityAction
google.gmail.list_messagesList Gmail messages
google.gmail.read_threadRead a Gmail thread
google.gmail.draft_messageCreate a Gmail draft
google.gmail.send_messageSend a Gmail draft
google.calendar.list_eventsList Calendar events
google.calendar.create_eventCreate a Calendar event
google.drive.searchSearch Drive
google.drive.read_fileRead a Drive file

Backed by the gmail.modify, calendar.events, and drive.readonly scopes.


Connected services and tools

CapabilityAction
connector.remote.operation.invoke_readRead from a connected service
connector.remote.operation.invoke_writeUpdate a connected service
mcp.remote.tool.invoke_readRead with a connected tool
mcp.remote.tool.invoke_writeMake a change with a connected tool
mcp.local.tools.listList local tools
mcp.local.tool.invoke_readRead with a local tool
mcp.local.tool.invoke_mutationRun a local tool that makes changes
channel.remote.message.sendSend a message to a verified messaging channel

Documents

CapabilityAction
artifacts.createCreate a document
artifacts.exportExport a document
artifacts.inspectInspect a document and produce a preview
deliverables.export_executive_docxExport a structured Word document
deliverables.export_financial_xlsxExport an Excel workbook with verified formulas
document.local.query_sectionRead a section of an indexed document
document.project.queryAnswer a question across a project's indexed documents, bound to cited passages
document.project.generate_vendor_comparison_matrixCompare 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

CapabilityAction
project.scratchpad.readRead the project's Notes
project.scratchpad.appendAdd to the project's Notes
memory.internal.readRead saved memories
memory.internal.rememberSave a memory
memory.internal.forgetForget a memory

Memories are scoped global or project, up to 16,000 bytes each.


Mods

CapabilityAction
mods.asset.readRead a declared knowledge file from a Mod
mods.state.readRead a Mod's declared state keys
mods.state.replaceWrite a Mod's declared state keys

The entire Mod surface. See the Mod package specification.


Web and system

CapabilityAction
web.public.retrieveRun one public web search and return its results. DuckDuckGo Lite over direct HTTPS first, headless Brave Search second. Never displays a browser
web.public.researchThe multi-source research executor. Still registered for its existing callers; ordinary chat and @Search both use web.public.retrieve
workflows.scheduled.createCreate a scheduled workflow
system.runtime_statusReport OOMU's own runtime state
system.registered_tool.runRun a registered tool
code.apply_patchApply an exact code patch
oomu.quick_launcher.calculateEvaluate a calculation natively, in exact decimal arithmetic

Product-only capabilities that open a destination in the interface. These are registered but not offered to the model as selectable actions.

CapabilityOpens
app.chat.openChat
app.projects.openProjects
app.workflows.openWorkflows
app.artifacts.openDocuments
app.connections.openConnections
app.mods.openMods
app.profile.openProfile
app.settings.openSettings

Availability

A capability being in this catalog does not mean it is usable right now. Three things gate it:

GateEffect
macOS permissionApple, screen, and file capabilities require the relevant TCC grant. See Settings → Mac access.
Connection stateGoogle, connector, MCP, and channel capabilities require a live connection.
Air-Gap ModeBlocks 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.