Skip to main content
OpenSRE’s interactive shell supports a session-local background mode for investigations. When background mode is enabled:
  • new investigations run asynchronously
  • the shell stays free for more questions and follow-ups
  • completed RCAs are tracked in-session
  • completion notifications can be sent to email (via the smtp integration), Telegram (via the telegram integration), Rocket.Chat (via the rocketchat integration), Buzz (via the buzz integration), or any combination
This first version is session-local only. If the REPL process exits, in-flight background jobs stop with it.

​
Commands

​
Typical flow

  1. Start the interactive shell.
  2. Enable background mode:
  1. Choose where the completed RCA is delivered. Channels are empty by default — skip this and no notification is sent:
  1. Start an investigation:
or paste a fresh alert in free text.
  1. Keep using the shell while the RCA runs.
  2. When it completes:
    • inspect it with /background show <task_id>
    • adopt it into active follow-up context with /background use <task_id>

​
RCA summary contents

Completed background jobs store:
  • root cause
  • top analysis items
  • recommended next steps
  • internal stats:
    • tool call count
    • investigation loop count
    • validity score

​
Completion notifications

Notifications are off by default — pick your channels with /background notify set. All channels send the same summary — Root cause, Top analysis, What to do next, plus a short internal stats section. Telegram, Rocket.Chat, and Buzz messages are plain text and are capped at the 4,096-character limit. Check what was actually delivered with /background show <task_id>: the notify row shows one result per channel — sent, failed: <error>, or a setup hint such as missing telegram integration: TELEGRAM_BOT_TOKEN is not set.
A notification problem never fails the investigation. If a channel is unconfigured or delivery errors, the RCA still completes, stays in /background list, and can still be promoted with /background use.

​
Current v1 limits

  • interactive shell only — there is no opensre background … CLI command
  • jobs are not persisted across REPL restarts
  • completion does not automatically replace your active follow-up context
  • you must run /background use <task_id> to promote a finished RCA