Skip to content

OpenTrace

Overview

opentrace/opentrace

Architecture Overview¶

┌──────────────────────────────────────────────────────┐
│                    UI (React/TS)                     │
│         Browser-based indexer + graph explorer       │
│           localhost:5173         ┌─────────────────┐ │
│                                  │  Web Worker     │ │
│                                  │  tree-sitter    │ │
│                                  │  WASM parsers   │ │
│                                  └─────────────────┘ │
│                                  ┌─────────────────┐ │
│                                  │  LadybugDB WASM │ │
│                                  │  graph store    │ │
│                                  └─────────────────┘ │
└──────────────────────────────────────────────────────┘

Components¶

UI (`ui/`)¶

React/TypeScript frontend that runs entirely in the browser. Includes:

Graph Explorer — visual graph navigation and search
Tree-sitter Web Worker — parses source files using WASM grammars
LadybugDB WASM — embedded graph database for storing and querying the knowledge graph
Chat Agent — in-app AI agent with access to graph tools via MCP

Agent (`agent/`)¶

Python agent that loads data into the knowledge graph. Managed with uv, it runs as an MCP server and handles data ingestion from external sources.

Protobuf Definitions (`proto/`)¶

Shared API contracts used across components.

Claude Code Plugin (`plugins/claude-code/`)¶

MCP server configuration that connects Claude Code to OpenTrace. See the Claude Code Plugin reference for details.

OpenCode Plugin (`plugins/opencode/`)¶

Native TypeScript plugin that runs inside OpenCode's Bun runtime — calls the opentraceai CLI directly rather than going through MCP. See the OpenCode Plugin reference for details.