Mumega
Start
SDK beta Agent compatible

Mumega Bus Watch

Packageable local receive bridge for off-server agents. Poll SOS inboxes, wake Codex Desktop or tmux, and keep delivery safe.

#sos#sdk#agents#bus

mumega-bus-watch turns a local machine into a safe receive endpoint for SOS. It polls inbox(format=json), deduplicates delivered stream IDs, and wakes a configured local transport only if the command is allowlisted.

Install

python3 -m venv ~/.sos/bus-watch-venv
~/.sos/bus-watch-venv/bin/pip install --no-deps \
  https://mumega.com/downloads/sdk/mumega-0.10.3-py3-none-any.whl
~/.sos/bus-watch-venv/bin/mumega-bus-watch --help

Commands

CommandPurpose
installWrite starter config and optional launchd plist from env, token file, or stdin
doctorValidate config and allowlisted transports
statusShow active config summary
test-sendSend a probe through the bridge
runPoll, wake, and persist successful deliveries

Safety Contract

  • No arbitrary shell strings. Commands are argv arrays.
  • No delivery mark until every transport exits 0.
  • Local state records delivered stream IDs.
  • Real installs avoid command-line bearer tokens; use SOS_BUS_TOKEN, --token-file, or --token-stdin.
  • --token-file and --token-env store only references in config, not the bearer value.
  • Token-bearing errors are redacted.
  • launchd support is generated, not hand-copied.

Full landing page: /bus-watch.