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

# Welcome to GoBetter

> Autonomous AI-powered Pull Request Reviews with Zero-Nitpick Intelligence

# GoBetter Documentation

GoBetter is an autonomous code review engine and developer intelligence platform designed to deliver high-signal, deep architectural pull request reviews. It intercepts GitHub PR webhooks, isolates diff context, coordinates background review workers across distributed queues, and posts actionable findings directly to your pull requests.

## Explore GoBetter

<Card title="Supercharge Your AI Coding Agents with GoBetter MCP" icon="https://mintcdn.com/gobetter-530c621c/hlnnFD_JVkwbHQAs/assets/mcp.svg?fit=max&auto=format&n=hlnnFD_JVkwbHQAs&q=85&s=006517865dc3bf02c02d6bf74f2e20cc" width="24" height="24" data-path="assets/mcp.svg">
  Give your AI coding assistants instant access to GoBetter docs, architecture specs, and API schemas—right inside your editor.

  <div className="not-prose flex flex-wrap gap-2.5 pt-2 pb-3">
    <a href="cursor://anysphere.cursor-deeplink/mcp/install?name=gobetter&config=eyJ1cmwiOiJodHRwczovL2RvY3MuZ29iZXR0ZXIuZGV2L21jcCJ9" className="inline-flex items-center gap-1.5 px-3 py-1.5 rounded-md text-xs font-semibold bg-zinc-900 text-white hover:bg-zinc-800 dark:bg-zinc-100 dark:text-zinc-900 dark:hover:bg-zinc-200 shadow-sm transition-colors">
      <svg viewBox="0 0 467 533" width="13" height="13" fill="currentColor" className="shrink-0">
        <path d="M457.43 125.94 244.42 2.96a22.13 22.13 0 0 0-22.12 0L9.3 125.94C3.55 129.26 0 135.4 0 142.05v247.99c0 6.65 3.55 12.79 9.3 16.11l213.01 122.98a22.13 22.13 0 0 0 22.12 0l213.01-122.98c5.75-3.32 9.3-9.46 9.3-16.11V142.05c0-6.65-3.55-12.79-9.3-16.11zm-13.38 26.05L238.42 508.15c-1.39 2.4-5.06 1.42-5.06-1.36V273.58c0-4.66-2.49-8.97-6.53-11.31L24.87 145.67c-2.4-1.39-1.42-5.06 1.36-5.06h411.26c5.84 0 9.49 6.33 6.57 11.39h-.01Z" />
      </svg>

      Add to Cursor
    </a>

    <a href="https://vscode.dev/redirect/mcp/install?name=gobetter&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fdocs.gobetter.dev%2Fmcp%22%7D" className="inline-flex items-center gap-1.5 px-3 py-1.5 rounded-md text-xs font-semibold bg-zinc-900 text-white hover:bg-zinc-800 dark:bg-zinc-100 dark:text-zinc-900 dark:hover:bg-zinc-200 shadow-sm transition-colors">
      <svg viewBox="0 0 100 100" width="13" height="13" fill="currentColor" className="shrink-0">
        <path fillRule="evenodd" clipRule="evenodd" d="M70.912 99.317a6.22 6.22 0 0 0 4.96-.19l20.589-9.907A6.25 6.25 0 0 0 100 83.587V16.413a6.25 6.25 0 0 0-3.54-5.632L75.874.874a6.23 6.23 0 0 0-7.104 1.21L29.355 38.04 12.187 25.01a4.16 4.16 0 0 0-5.318.236l-5.506 5.009a4.17 4.17 0 0 0-.004 6.162L16.247 50 1.36 63.583a4.17 4.17 0 0 0 .004 6.162l5.506 5.01a4.16 4.16 0 0 0 5.318.236l17.168-13.032L68.77 97.917a6.2 6.2 0 0 0 2.143 1.4ZM75.015 27.3 45.11 50l29.906 22.701z" />
      </svg>

      Add to VS Code
    </a>
  </div>

  <Accordion title="Add manually & CLI (Cursor, VS Code, Claude Code, Codex)">
    <Tabs>
      <Tab title="Cursor">
        Add the GoBetter MCP server to your Cursor `mcp.json` (`Cmd/Ctrl` + `Shift` + `P` → `Open MCP settings`):

        ```json theme={null}
        {
          "mcpServers": {
            "gobetter": {
              "url": "https://docs.gobetter.dev/mcp"
            }
          }
        }
        ```
      </Tab>

      <Tab title="VS Code">
        Add the GoBetter server to `.vscode/mcp.json`:

        ```json theme={null}
        {
          "servers": {
            "gobetter": {
              "type": "http",
              "url": "https://docs.gobetter.dev/mcp"
            }
          }
        }
        ```
      </Tab>

      <Tab title="Claude Code">
        Connect via CLI command:

        ```bash theme={null}
        claude mcp add --transport http gobetter https://docs.gobetter.dev/mcp
        ```
      </Tab>

      <Tab title="Codex CLI">
        Add the GoBetter MCP entry to `~/.codex/config.toml`:

        ```toml theme={null}
        [mcp_servers.gobetter]
        url = "https://docs.gobetter.dev/mcp"
        ```
      </Tab>
    </Tabs>
  </Accordion>
</Card>

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/quickstart">
    Set up and run GoBetter locally with PostgreSQL, Redis, and Vite in under 5 minutes.
  </Card>

  <Card title="Architecture" icon="diagram-project" href="/architecture/architecture">
    Explore the webhook ingestion lifecycle, BullMQ queues, and state handler transitions.
  </Card>

  <Card title="Server Configuration" icon="server" href="/config/serverConfiguration">
    Configure backend environment variables, database connections, and AI provider routing.
  </Card>

  <Card title="Client Configuration" icon="sliders" href="/config/clientConfiguration">
    Customize frontend runtime settings, local storage toggles, and feature flags.
  </Card>
</CardGroup>

***

## Core Capabilities

<AccordionGroup>
  <Accordion title="High-Signal Review Engine" defaultOpen={true}>
    GoBetter is tuned for **zero-nitpick reviews**. Rather than spamming pull requests with style or formatting comments, the agent specifically targets critical architectural flaws, security risks, concurrency defects, and logic regressions.
  </Accordion>

  <Accordion title="Bring Your Own Key (BYOK) & Custom Models">
    Connect your own API keys for OpenAI, Anthropic Claude, Google Gemini, DeepSeek, or custom OpenAI-compatible enterprise gateways. All API keys are encrypted at rest using symmetric AES-256-GCM.
  </Accordion>

  <Accordion title="Distributed Async Architecture">
    Webhook payloads are immediately acknowledged and dispatched to Redis-backed BullMQ queues. Independent workers handle payload sanitization, resource extraction, AI inference, and notification dispatch.
  </Accordion>

  <Accordion title="Interactive Web Dashboard">
    Inspect pull request review histories, toggle automated reviews, configure prompt instructions per review mode (Quick, Standard, Deep Dive), and manage active sessions across devices.
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={3}>
  <Card title="Getting Started" icon="play" href="/quickstart">
    Run the platform locally.
  </Card>

  <Card title="AI Harness" icon="robot" href="./technical-guides/ai-and-harness/harness">
    Learn how agents and skills are organized.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/overview">
    Explore backend endpoints and schemas.
  </Card>
</CardGroup>
