System tray presence

Orch presence puts a tray icon on Windows and macOS — glance status, desktop notify bridge, and one click to open orch ui. Not a TUI; not Team commerce.

Goal#

Keep Orch visible while the gateway runs as a background service and you work in other windows. The tray is presence + a door into orch ui, not a replacement chat or a Team admin console.

  gateway (service)          ← machine process
        ↑ poll
  orch presence (tray)       ← glance + toasts + open
        │ left-click
        ↓
  orch ui (127.0.0.1:8790)   ← workshop board / HITL / usage

Steps#

  1. From a linked workshop:

    orch presence run

    Left-click the tray icon (or Open Workshop) starts orch ui if needed and opens the browser. Right-click shows plan, linked, gateway, workers, and pending HITL counts.

  2. Optional — start presence at user login (does not replace the gateway service). Prefer the Workshop UI:

    Settings (first card: Start Orchemax with this session) → Turn on at login

    Or from the CLI:

    orch presence install
orch presence status
orch presence uninstall

    Turning the setting on also registers the gateway background service.

  3. Desktop toasts (sealed, needs_approval, …) still use the existing notify desktop channel. Clicking a Windows toast opens /app/board. Question toasts are skipped while orch ui was used in the last ~45 seconds so you are not double-notified while looking at the workshop.

  1. Open Workshop
  2. Status lines (plan / linked / gateway / workers / HITL)
  3. Restart gateway
  4. Open status page
  5. Open notify log
  6. Quit Orch presence (gateway keeps running)

What this is not#

  • Not a TUI and not Electron. Detail lives in orch ui.
  • Not orchemax.com/app commerce (billing, members, overlook).
  • On Linux, orch presence run tells you to use orch ui until a tray port exists.

See also#