Skip to content
Back to search

antigravity-headless-puppeteer

One-command Puppeteer MCP setup for Antigravity CLI on headless Linux servers

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/advisingdesert--antigravity-headless-puppeteer/badge.svg)](/listings/advisingdesert--antigravity-headless-puppeteer)

HTML

<a href="/listings/advisingdesert--antigravity-headless-puppeteer"><img src="/api/listings/advisingdesert--antigravity-headless-puppeteer/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/AdvisingDesert/antigravity-headless-puppeteer.git
cd antigravity-headless-puppeteer
chmod +x setup.sh start_mcp.sh
./setup.sh

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 42 lines
  1. # Antigravity CLI — Headless Puppeteer MCP (Linux)
  2. One-command setup to give **Antigravity (`agy`)** full web browsing capabilities on a headless Linux server (Ubuntu 24.04 / Debian) using the official Puppeteer MCP server.
  3. ## Why this exists
  4. Setting up `@modelcontextprotocol/server-puppeteer` on a headless server usually fails silently, leaving the agent without browser tools. This repo fixes the three main blockers out of the box:
  5. - **Ubuntu 24.04 `t64` transition:** handles the `libasound2` → `libasound2t64` package change automatically.
  6. - **Root cache lockouts:** bypasses `/root/.cache/puppeteer` permission errors caused by global `sudo npm` installs.
  7. - **Snap/System Chromium routing:** dynamically points Puppeteer to the system Chromium binary via a lightweight wrapper.
  8. ## Requirements
  9. - Ubuntu / Debian Linux (headless)
  10. - Node.js & `npm`
  11. - Antigravity CLI (`agy`)
  12. ## Quick Start
  13. ```bash
  14. git clone https://github.com/AdvisingDesert/antigravity-headless-puppeteer.git
  15. cd antigravity-headless-puppeteer
  16. chmod +x setup.sh start_mcp.sh
  17. ./setup.sh
  18. ```
  19. ## Verify
  20. check that the MCP server is active:
  21. ```bash
  22. agy mcp list
  23. ```
  24. Run a quick browsing test:
  25. ```bash
  26. agy --dangerously-skip-permissions --print "Use puppeteer to visit example.com and return only the exact page title."
  27. ```
  28. ## How it works
  29. agy CLI ──► start_mcp.sh (sets PUPPETEER_EXECUTABLE_PATH) ──►
  30. @modelcontextprotocol/server-puppeteer ──► System Chromium
  31. - setup.sh installs the headless X11/ALSA dependencies, installs the MCP package globally, and registers start_mcp.sh in agy
  32. - start_mcp.sh is the entry point executed by agy in the background whenever you start a session.
  33. Once installed, Puppeteer is available globally across all your agy projects on the server.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.