SYNOPSIS

coral [command] [options]

DESCRIPTION

Coral is an AI-powered debugger designed for distributed systems. It gives AI assistants “hands” inside your running code by deploying eBPF probes and profiling live code in real-time. Unlike traditional observability tools, Coral is optimized for live investigation, allowing you to ask why a service is behaving a certain way rather than just seeing that it is.

CORE CAPABILITIES

• Zero Instrumentation: Works on running services via eBPF with no code changes required.
• AI-Powered Analysis: Returns root causes instead of raw metrics for LLM-driven troubleshooting.
• Deep Profiling: On-demand CPU and memory profiling with flame graphs (<1% overhead).
• Service Awareness: Indexes binaries to locate symbols and functions even without exact names.

EXAMPLES

Ask the AI to diagnose a latency spike:

$ coral ask "Why is the payment API slow?"

Analyze memory growth in a specific worker:

$ coral ask "Why is the order-processor using 10GB of RAM?"

ARCHITECTURE

Coral follows a decentralized architecture where agents collect telemetry and the Colony acts as a control plane/MCP server.

┌─────────────────────────────────────────────────────────────────┐
│  Your AI Assistant                                              │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐           │
│  │ Claude       │  │ VS Code /    │  │ coral ask    │           │
│  │ Desktop      │  │ Cursor       │  │ (terminal)   │           │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘           │
│         └─────────────────┴─────────────────┘                   │
└──────────────────────────┬──────────────────────────────────────┘
                           │ MCP Protocol
                           ▼
                  ┌────────────────────┐
                  │  Colony            │
                  │  (Control Plane)   │
                  └─────────┬──────────┘
                            │ Encrypted Mesh (WireGuard + gRPC)
                            ▼
       ┌────────────────────┴────────────────────┐
       │                                         │
       ▼                                         ▼
 ┌───────────┐                             ┌───────────┐
 │  Agent    │                             │  Agent    │
 │  • eBPF   │        ...more agents...    │  • eBPF   │
 │  • OTLP   │                             │  • OTLP   │
 └─────┬─────┘                             └─────┬─────┘
       │                                         │
 ┌─────▼─────┐                             ┌─────▼─────┐
 │ Service A │                             │ Service B │
 │ (+ SDK)   │                             │ (No SDK)  │
 └───────────┘                             └───────────┘

SEE ALSO

Official Website: https://coralmesh.dev

Source Code: https://github.com/alexandrem/coral

BUGS

Very early and experimental. APIs are subject to change.