Omniscio documentation
Browse all documentation
  1. Getting Started19
  2. Sessions & Agents134
  3. Inbox & Notifications69
  4. Projects & Tasks100
  5. Automation & Scheduling76
  6. Knowledge & Memory28
  7. AI Features72
  8. Integrations114
  9. Plugins & Marketplace42
  10. Cloud & Teams52
  11. Settings & Customization79
  12. Account & Billing28
  13. Troubleshooting81
  14. CLI & API Reference28
  15. Legal & Policies5
  16. Uncategorised17

Background Work Registry

Omniscio runs timers, helper processes and maintenance jobs in the background. The Background tab shows all of them in one table, says which part of the app owns each one, and tells you whether it is using more than it was allowed to.

What it is

A read-only view of the work Omniscio does without being asked: timers that poll, watchers that react, helper processes that stay resident and jobs that run on a schedule. Each item carries the owner responsible for it, the file or script behind it, its current state, its measured cost, and a verdict against the cost budget its owner declared.

Where to find it

Settings → Help → Diagnostics → Background, on the tab beside Resources.

How it behaves

  • The tab reads once when you open it, and again when you press Refresh. It never polls, so opening it can never add steady load to a machine that already feels slow.
  • Rows are grouped by owner, so the answer to "who is responsible" is the section heading.
  • A number is a real measurement of that item. "—" with "Not measured" means nothing times this item — it never means zero, and it is never treated as healthy.
  • "No budget declared" means the owner never stated a limit, so there is nothing to compare against. That is a gap in the declaration, not a clean bill of health.
  • The rule behind it: every background item is declared in one registry, and a new timer, daemon or scheduled job cannot be added without a declaration — the build fails instead. Work that predates the registry is adopted with a reason and a count, and that list can only shrink.

For agents

GET /diag/background on the local control server returns the same table as JSON. It is read-only, charged against the caller's read budget, and reachable with a session's own scoped token, so an agent answers "what is running and what is too expensive" from data instead of guessing.

Related

Last verified 2026-10-19