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), 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 and Rocket.Chat 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