opentrace

<p align="center">
  <strong>OpenTrace</strong><br/>
  <em>Give your AI coding agent eyes into production</em>
</p>

<p align="center">
  <a href="https://github.com/adham90/opentrace/releases"><img src="https://img.shields.io/github/v/release/adham90/opentrace?style=flat-square" alt="Release"></a>
  <a href="https://github.com/adham90/opentrace/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/adham90/opentrace/ci.yml?branch=main&style=flat-square&label=CI" alt="CI"></a>
  <a href="https://github.com/adham90/opentrace/blob/main/LICENSE"><img src="https://img.shields.io/github/license/adham90/opentrace?style=flat-square" alt="License"></a>
</p>

<p align="center">
  <a href="#how-it-works">How It Works</a> ·
  <a href="#get-started">Get Started</a> ·
  <a href="#what-can-the-agent-do">Features</a> ·
  <a href="#mcp-tools">MCP Tools</a> ·
  <a href="#security">Security</a>
</p>

---

Your AI coding assistant can read your code — but it's **blind to production**. When something breaks, you copy-paste stack traces, dig through log dashboards, and manually feed context into chat.

OpenTrace fixes that. It's a self-hosted server that connects your AI agent directly to your production observability data via [MCP](https://modelcontextprotocol.io). No dashboards, no UI — **the agent is the interface**.

```
You:    "Why is the checkout endpoint throwing 500s?"

Agent:  Error rate on POST /api/checkout spiked from 0.1% to 4.2%
        starting 8 minutes ago. 23 errors, 12 affected users.

        Root cause: NilPointerError at payments_controller.rb:87
        — customer.address is nil when charging.

        This started after the latest deploy (commit a1b2c3d by
        [email protected]). The commit modified payments_controller.rb
        lines 82-95.

        Want me to fix it?
```

---

## How It Works

```
Your App                                Your Server
┌──────────────────────┐               ┌──────────────────────────────────┐