Trace Core Engine
Trace is an AI-powered debugging intelligence engine that understands web application state and provides automated analysis.Plan
Given a debugging question, decides which tools to execute.
Analyze
Given tool results, provides human-readable explanations.
What It Actually Is
One API to rule them all.- Input: User Query + Tool Execution Results
- Output: Intelligent analysis, issues, recommendations
Trace is stateless. It does not store browser data. It relies on clients (Extension, SDK, CLI) to capture state and execute tools.
How it works
1
User Asks Question
Client sends query to
/v1/plan.2
Engine Plans Tools
Engine returns a plan (e.g., “Run
get_dom_state”).3
Client Executes Tools
Client runs tools via CDP/Puppeteer and sends results to
/v1/analyze.4
Engine Analyzing Insights
Engine returns a human-readable explanation and fix.
Clients (One Brain, Many Hands)
| Client | Executes Tools Via | Use Case |
|---|---|---|
| Extension | CDP (local browser) | Live debugging in Chrome |
| SDK | Puppeteer / CDP | CI/CD pipelines, automated tests |
| CLI | Puppeteer / CDP | Terminal-based debugging |