gasoline-cli

Adding fuel to the AI fire. Captures browser console logs, network errors, and exceptions for your AI coding assistant via MCP.

Quick Start

Claude Code (MCP)

Add to your project's .mcp.json or Claude Code settings:

{
  "mcpServers": {
    "gasoline": {
      "command": "npx",
      "args": ["gasoline-cli", "--mcp"]
    }
  }
}

Cursor / Windsurf

Add to your MCP configuration:

{
  "mcpServers": {
    "gasoline": {
      "command": "npx",
      "args": ["gasoline-cli", "--mcp"]
    }
  }
}

Manual Server Mode

npx gasoline-cli

Starts an HTTP server on http://localhost:7890 that receives logs from the browser extension and writes them to ~/gasoline-logs.jsonl.

Browser Extension

Install the Gasoline Chrome Extension to capture browser logs and send them to the server.

Options

gasoline-cli [options]

  --port <number>        Port to listen on (default: 7890)
  --log-file <path>      Path to log file (default: ~/gasoline-logs.jsonl)
  --max-entries <number> Max log entries before rotation (default: 1000)
  --mcp                  Run in MCP mode for AI tool integration
  --version              Show version
  --help                 Show help

MCP Tools

When running with --mcp, the following tools are available to your AI assistant:

• get_browser_errors - Get recent browser errors (console errors, network failures, exceptions)
• get_browser_logs - Get all browser logs (errors, warnings, info)
• clear_browser_logs - Clear the log file

Supported Platforms

• macOS (Apple Silicon & Intel)
• Linux (x64 & ARM64)
• Windows (x64)