Omniscio

Plugin access to your inbox

A plugin you approve can see the titles of what is waiting for you in your own inbox: your open inbox items and the sessions waiting on you. It never sees what they say. It is off until you turn on Plugin access to your inbox in Settings, Labs.

On this page

What it is

A plugin can ask for one permission, shown on its install card:

Permission What it lets the plugin do
Inbox (inbox.read) See the titles of your open inbox items and sessions waiting on you, never their contents.

It is marked as elevated. It is separate from the older Inbox permission (inbox), which only lets a plugin add its own items to your inbox: a plugin can hold either one without the other.

Where to find it

  • The switch: Settings, Labs, Plugin access to your inbox. It starts off and hidden. While it is off, every inbox read from a plugin is refused.
  • Review: every read a plugin makes is written to its read log, which you can review.

What a plugin can and cannot do

  • Can: list your open inbox items and the sessions waiting on you, newest first. Each item has its id, whether it is an inbox card or a session, its title, when it arrived, and whether it is asking you something. A session's title is its name and its project's name.
  • Cannot: see an item's text, links, files, the prompt or form it carries, its fields, where it would take you, who sent it, or which session raised it. It cannot see snoozed or answered items, cards filed for an agent crew rather than you, cards any plugin posted (its own included), or sessions that are private (such as AI Coaching or your journal), hidden, reviewing someone else's work, or running on another computer. It cannot change, answer, snooze or dismiss anything.

How it behaves

  • "Waiting on you" means the same thing as the needs-you count in the sidebar, so a session the app is holding back from you (snoozed, scheduled, held for a crew, recovering, or being screened) is left out.
  • An inbox card counts as asking you something only when whoever raised it said so; the words are never guessed at.
  • A plugin can ask for 1 to 100 items; it gets 25 when it does not say. The answer says when more items were left out.
  • A plugin can make at most 60 reads a minute, shared with its other work-data reads.
  • Turning the switch off stops the very next read, with no restart.

Limits

  • At most 100 items per read.
  • Each read looks at the 200 most recently updated inbox cards and at most 200 waiting sessions.

Speed cost

Not measured yet. The feature adds no background work of its own (no timer, poller or watcher); it only does work when a plugin calls it, and each call is capped at 60 reads a minute. Each read asks for the open cards, the active snoozes and the waiting sessions once. The off-and-on measurement in the shared Speed Cost Format needs a plugin that actually uses this permission, and is owed before the feature goes to dogfood.

Plugin access to boards and tasks explains the sibling work-data permissions, Plugin control of your sessions covers managing the sessions you pick, Inbox Alerts explains the inbox cards themselves, the Plugin Marketplace page covers installing plugins and the consent card, and Plugin Developer Mode explains how a self-built plugin can use this permission before the marketplace lists it.

Last verified 2026-11-12