> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ladybugs.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Debug production bugs instantly with runtime context

## What is Ladybugs?

Ladybugs is a production debugging system that captures complete runtime context from your applications. Instead of relying on limited logs or trying to reproduce bugs locally, Ladybugs gives you full visibility into what actually happened in production—down to function calls, loops, data changes, and variable values.

## The Problem We Solve

Traditional debugging is time-consuming and frustrating:

* You receive a bug report but can't reproduce it locally
* Logs provide incomplete information about what went wrong
* You waste hours adding more logging and redeploying
* AI coding assistants need extensive context to help debug issues

## How Ladybugs Helps

Ladybugs eliminates the debugging loop by providing AI agents with complete production context:

<Card title="Zero-effort debugging" icon="wand-magic-sparkles">
  Simply tell your AI: "I tried to create a post with the title 'Banana' and it failed"—no need to debug manually or provide additional context.
</Card>

Your AI agent can then:

* Search for all relevant functions and data related to that specific request
* View real runtime data: function parameters, return values, variable states
* Trace low-level execution: conditions evaluated, loops executed, data accessed
* Perform instant root cause analysis and suggest fixes

## How It Works

<Steps>
  <Step title="Instrument your code">
    Ladybugs uses a Babel plugin to automatically add traces to your JavaScript/TypeScript code during the build process.
  </Step>

  <Step title="Collect runtime data">
    When your code runs in production, all execution data is captured and sent to your self-hosted Docker container.
  </Step>

  <Step title="Query with AI">
    Access all production data through our MCP (Model Context Protocol) integration, allowing AI agents to instantly understand and fix bugs.
  </Step>
</Steps>

## Supported Platforms

Currently, Ladybugs supports the JavaScript ecosystem:

* **Node.js** - Backend applications
* **React** - Frontend applications
* **TypeScript** - Full TypeScript support
* Other JavaScript frameworks and libraries

## Get Started

<CardGroup cols={2}>
  <Card title="Setup Guide" icon="rocket" href="/quickstart/setup">
    Install and configure Ladybugs in your local project
  </Card>

  <Card title="MCP Integration" icon="plug" href="/mcp/setup">
    Connect Ladybugs to your AI coding assistant via MCP
  </Card>

  <Card title="How It Works" icon="gears" href="/guides/how-it-works">
    Understand the technical details behind Ladybugs
  </Card>
</CardGroup>