> ## Content Index
> Fetch the complete content index at: https://claudefox.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# OpenSRE: an open-source agent that investigates failed CI runs and proposes fixes
- URL: https://claudefox.com/opensre-an-open-source-agent-that-investigates-failed-ci/
- Published: 2026-11-20T14:15:42.000Z
- Updated: 2026-11-20T14:16:03.000Z
- Description: OpenSRE is an open-source CLI agent for CI/CD reliability that investigates failed runs and proposes fixes instead of only reporting that a build broke.
- Author: hupicake
- Tags: Tools

Tracer-Cloud/opensre gives teams a way to stop re-running red builds blind: OpenSRE is a command-line agent that reads a failed CI run, traces the cause, and pushes a fix for the reader to review, and it had about 13,400 GitHub stars as of November 20, 2026.

![OpenSRE CLI welcome screen with the sign-in prompt](https://claudefox.com/content/images/lab/2026-11-20/opensre-an-open-source-agent-that-investigates-fai-img1-3f743e5454.png)

Image: Tracer-Cloud/opensre (Apache-2.0)

## What is OpenSRE?

OpenSRE is an open-source CLI agent for CI/CD reliability that investigates failed runs and proposes fixes instead of only reporting that a build broke.

When a run fails, OpenSRE fetches the failing checks and CI logs, recent commits and deploys, and correlated logs, metrics and traces, then reasons across the connected systems to test hypotheses, separates CI-caused failures from code-caused ones, and answers with an evidence-linked response. It then pushes a fix to the pull request branch for review, or suggests next steps, and can post a summary to Slack, PagerDuty or Telegram. The README describes it as built to run on a team's own infrastructure with that team's own models, and the project is in public alpha, so its core workflows are usable for early exploration but not yet fully stable.

## Who is OpenSRE for?

OpenSRE is for developers and site reliability engineers whose CI pipelines keep going red and who want the investigation done for them.

It fits teams using GitHub, GitLab or Jenkins for CI, and observability tools such as Grafana, Datadog or Sentry, since the README lists those among its integrations. The first-run demo works from a terminal open in a code project, with a Git repository recommended, and the quickstart's CI demo reads GitHub Actions history, so a connected GitHub account is part of that path. It runs on macOS, Linux and Windows, and the interactive shell takes plain-language questions about incidents.

## Quick facts

- Platform: macOS and Linux through the curl installer, and Windows through PowerShell.
- License: Apache License 2.0.
- Language: Python; building from source needs Python 3.12 or later.
- Latest release: v0.1.2026.11.20, published on November 20, 2026.
- Status: public alpha, with about 13,400 GitHub stars as of November 20, 2026.

## What stands out

- Investigates a failed run end to end: it reads logs, tests hypotheses and pushes a fix to the pull request branch for review, rather than only saying the build broke.
- Separates CI-caused failures from code-caused ones, so the fix targets the right cause.
- Reports what unreliable CI costs: the 30-day CI analysis covers failure rates, developer hours lost waiting on CI, and how long the default branch stays red.
- Connects to more than 60 tools and services, including Anthropic, OpenAI, Ollama, Grafana, Datadog, Kubernetes, AWS, PostgreSQL, GitHub, GitLab, Jenkins, PagerDuty and Slack.
- Works three ways: an interactive shell for plain-language questions, a headless one-shot command, and a Python API for driving the agent from your own code, with a source checkout required for the Python API.

![Image from the Tracer-Cloud/opensre README (2)](https://claudefox.com/content/images/lab/2026-11-20/opensre-an-open-source-agent-that-investigates-fai-img5-1a29033c51.png)

Image: Tracer-Cloud/opensre (Apache-2.0)

## How do I install OpenSRE?

OpenSRE installs on macOS or Linux with the project's curl installer, and on Windows with a PowerShell command, after which the opensre command starts it.

From the project's README, the installer fetches the latest build from main without requiring sudo, and if opensre is not found, the reader follows the PATH instructions printed by the installer or opens a new terminal. The Releases page lists dated builds, including the latest release.

```
curl -fsSL https://install.opensre.com | bash -s -- -gh
```

```
& ([scriptblock]::Create((irm https://install.opensre.com/install.ps1))) -gh
```

```
opensre
```

```
opensre ask "why is checkout-api slow?"
```

```
opensre integrations setup
```

```
opensre update
```

Signing in on first launch activates the hosted model, so no LLM key is needed, and the shell then offers a demo or a plain prompt.

![Image from the Tracer-Cloud/opensre README (3)](https://claudefox.com/content/images/lab/2026-11-20/opensre-an-open-source-agent-that-investigates-fai-img6-2a418fd63c.png)

Image: Tracer-Cloud/opensre (Apache-2.0)

## How it was built with Claude

The repository contains CLAUDE.md, which references AGENTS.md, and AGENTS.md sets repository-wide rules for agents working in the code, while a .claude folder holds settings that allow uv run and python commands. No Co-Authored-By trailer naming Claude appears in the first 100 commits returned by the GitHub API, so this post does not claim the project was built with Claude.

**Try it with your AI.** Paste this into your own AI assistant to try OpenSRE on a failing build, using only the project's own commands.

```
Help me try OpenSRE on [my repository] without changing anything yet. First, show me
every step you plan to take, starting with the risky ones, and wait for my confirmation
before running anything. Use only the official commands from the OpenSRE README: install
with `curl -fsSL https://install.opensre.com | bash -s -- -gh` on macOS or Linux, start
it with `opensre`, ask one question with `opensre ask "why is checkout-api slow?"`, and
connect tools only with `opensre integrations setup`. Do not install anything from
unknown sources, do not touch credential files, do not delete anything, and do not use
any keys or tokens. After I confirm, help me sign in, then ask OpenSRE to explain the
failure in [pull request number] in plain language, and show me the fix it proposes
without applying or pushing it. Tell me where the fix would be pushed for review, what
it would change, and what I should check first. If OpenSRE asks for GitHub access or a
sign-in I have not given, stop and tell me what it needs instead of working around it.
```

## What are OpenSRE's limits?

OpenSRE is in public alpha, so its core workflows are usable for early exploration but its APIs and integrations may still change.

- The interactive shell needs a terminal: it starts a REPL only when run with no subcommand, and the shell only opens for an active account.
- Signing in activates the hosted model, and the CI demos need a connected GitHub account; fixing and pushing a change needs Contents and Pull requests write access on the repository.
- Prebuilt Linux binaries need glibc 2.35 or later, equivalent to Ubuntu 22.04 or newer, and Alpine and musl are unsupported.
- Telemetry and prompt logging are on by default: first-party analytics and Sentry are opt-out, and each agent turn is recorded locally and forwarded as a product-analytics event, with redaction that catches known token shapes only.
- The shell history file is plain text on local disk, and the README says there is no silent bulk export of raw logs, with local transcript handling by default.

```
export OPENSRE_NO_TELEMETRY=1
```

Sensitive identifiers are masked before external model calls only when masking is turned on, since the README calls masking optional.

## Related on claudefox

- [PhoneBox turns an old Android phone into a desk panel and control deck for Windows, Linux and macOS](https://claudefox.com/phonebox-old-android-phone-desk-panel/)
- [AWS releases AWS Emulator, a free local copy of its APIs written entirely by AI agents](https://claudefox.com/aws-emulator-local-aws-apis-written-by-ai-agents/)
- [stack-diagram: an unofficial agent skill that turns one sentence into an architecture diagram with official logo files](https://claudefox.com/stack-diagram-agent-skill-architecture-diagram-official-logos/)
- [agentes.chat: a self-hosted Slack alternative where AI agents sit in your channels](https://claudefox.com/agentes-chat-self-hosted-slack-alternative-ai-agents/)

## Problems and feedback

Report bugs and request features on the project's GitHub Issues page, where the README also points first-time contributors to good first issue tickets. For a security vulnerability, do not open a public GitHub issue; email support@opensre.com instead, with a description, the affected component and version, steps to reproduce, and the impact.

Source: [Tracer-Cloud/opensre repository](https://github.com/Tracer-Cloud/opensre?ref=claudefox.com), [OpenSRE README](https://github.com/Tracer-Cloud/opensre/blob/main/README.md?ref=claudefox.com), [OpenSRE releases](https://github.com/Tracer-Cloud/opensre/releases?ref=claudefox.com), [OpenSRE issues](https://github.com/Tracer-Cloud/opensre/issues?ref=claudefox.com), [OpenSRE security policy](https://github.com/Tracer-Cloud/opensre/blob/main/SECURITY.md?ref=claudefox.com), [OpenSRE agent instructions (AGENTS.md)](https://github.com/Tracer-Cloud/opensre/blob/main/AGENTS.md?ref=claudefox.com), [OpenSRE CLAUDE.md](https://github.com/Tracer-Cloud/opensre/blob/main/CLAUDE.md?ref=claudefox.com), [OpenSRE setup guide (SETUP.md)](https://github.com/Tracer-Cloud/opensre/blob/main/SETUP.md?ref=claudefox.com), [OpenSRE pyproject.toml](https://github.com/Tracer-Cloud/opensre/blob/main/pyproject.toml?ref=claudefox.com), [OpenSRE quickstart](https://www.opensre.com/docs/getting-started/quickstart?ref=claudefox.com), [OpenSRE FAQ](https://www.opensre.com/docs/guides/faq?ref=claudefox.com), [OpenSRE local install](https://www.opensre.com/docs/install/install-local?ref=claudefox.com), [OpenSRE interactive shell privacy](https://www.opensre.com/docs/platform/interactive-shell-privacy?ref=claudefox.com), [OpenSRE CI/CD overview](https://www.opensre.com/docs/cicd/overview?ref=claudefox.com)

This story first appeared in the [claudefox daily briefing for November 20, 2026](https://claudefox.com/daily-2026-11-20/).