How to Install Gasoline Agentic Devtools in 5 Minutes (Mac, Windows, Linux)
If this is your first time using Gasoline Agentic Devtools, this guide is the fastest way to get running.
No jargon. Just the steps.
Quick Terms
Section titled “Quick Terms”- CLI (Command Line Interface): A text-based way to run commands.
- MCP (Model Context Protocol): A standard that lets AI tools talk to external tools. https://modelcontextprotocol.io/specification/
What You Will Have at the End
Section titled “What You Will Have at the End”- Gasoline installed
- Chrome extension loaded
- Your first successful health check
Step 1: Run the installer
Section titled “Step 1: Run the installer”Use one command based on your system.
macOS or Linux
Section titled “macOS or Linux”curl -sSL https://raw.githubusercontent.com/brennhill/gasoline-agentic-browser-devtools-mcp/STABLE/scripts/install.sh | bashWindows (PowerShell)
Section titled “Windows (PowerShell)”irm https://raw.githubusercontent.com/brennhill/gasoline-agentic-browser-devtools-mcp/STABLE/scripts/install.ps1 | iexStep 2: Load the extension in Chrome
Section titled “Step 2: Load the extension in Chrome”- Open
chrome://extensions/ - Turn on Developer mode
- Click Load unpacked
- Select
~/GasolineAgenticDevtoolExtension
Step 3: Verify installation
Section titled “Step 3: Verify installation”Run:
~/.gasoline/bin/gasoline-agentic-browser --doctorYou want to see a healthy result, not missing dependency errors.
Step 4: Do a first real check
Section titled “Step 4: Do a first real check”Open any webpage and try a simple call from your AI tool:
observe({what: "errors"})If it returns data, you are live.
Common Fixes
Section titled “Common Fixes”- Installer command fails: retry with stable internet and no VPN/proxy blocking GitHub.
- Extension does not appear: reload extensions page and confirm Developer mode is on.
- Tool cannot connect: rerun
--doctorand confirm local daemon is running.
Image and Diagram Callouts
Section titled “Image and Diagram Callouts”[Image Idea] Installer command shown in terminal on macOS, Windows, and Linux.
[Image Idea] Chrome extension “Load unpacked” step.
[Diagram Idea] Install flow: install binary -> load extension -> run doctor -> first observe call.