Skip to main content
The Trace CLI (trace) is your terminal-based intelligence engine. It allows you to debug deployed sites, local servers, and production apps directly from your command line.

​
🚀 Installation

​
🔑 Authentication

Most advanced features (AI Analysis) require an API key.

​
🛠️ Main Commands

​
1. trace analyze <url> (Alias: a)

The most powerful command. It connects to the page, plans a debugging strategy, and executes it using AI.
Options:
  • -q, --query <text>: Ask a specific question (e.g., “Why is the cart empty?”).
  • --no-headless: Watch the browser interactions in real-time.
  • --json: Output raw JSON for CI/CD pipelines.

​
2. trace repl <url> (Alias: r)

Starts an Interactive Debugging Session. You can type questions to the AI or run slash commands.
REPL Commands:
  • /debug: Run a full scan.
  • /errors: Show console errors.
  • /eval <js>: Run JavaScript in the browser context.
  • /screenshot: Capture the current view.
  • Why is the font wrong?: Ask the AI directly.

​
3. trace debug <url> (Alias: d)

Runs a standard comprehensive scan (Console + Network + DOM) without a specific user query.

​
⚡ Quick Tools

​
Console & Errors

Check for runtime exceptions.

​
Network Analysis

Find failed requests (404, 500) and performance bottlenecks.

​
Performance

Get Core Web Vitals (FCP, LCP) and a breakdown of JS heap usage.

​
Accessibility

Run an automated a11y audit (contrast, aria labels).

​
Health Check

Simple pass/fail check for CI/CD. Returns exit code 0 (Healthy) or 1 (Issues).

​
🔍 Inspection

​
Inspect Element

Get the DOM properties, visibility, and calculated styles of an element.

​
List All Tools

See the full list of 96+ variable tools available to the engine.