Latchshot for Gemini CLI

Give Gemini CLI two bounded tools for public-page artifacts without installing a browser locally:

• capture_page returns a PNG, JPEG, or PDF plus render diagnostics.

• get_usage reads the current plan and successful-render allowance without consuming quota.

The extension contains no executable code, hooks, commands, skills, agents, or always-on prompt content. It connects Gemini CLI directly to Latchshot's hosted MCP Streamable HTTP endpoint. Gemini CLI stores the API key as a sensitive extension setting and injects it only into the fixed authorization header.

Requirements

• Gemini CLI 0.51.0 or newer.

• A recurring Free-plan Latchshot key. The Free plan includes 100 successful renders per UTC calendar month and requires no credit card.

Install

Install the extension from its public GitHub repository:

gemini extensions install https://github.com/BaiqingL/latchshot-gemini-cli

Review the manifest when Gemini CLI asks for consent, then enter the Latchshot API key at the configuration prompt. The manifest marks the key as sensitive so Gemini CLI stores it through its secure extension-settings path. Do not pass --skip-settings.

Restart Gemini CLI, then run /extensions list or this terminal command:

gemini extensions list

The Latchshot server should expose capture_page and get_usage. To replace the key later, run:

gemini extensions config latchshot "Latchshot API key"

Example

Ask Gemini:

Use Latchshot to capture https://example.com as an 800 by 450 PNG. Report the byte count, render time, navigation state, fonts state, scripts state, and remaining quota.

A controlled integration check should use a disposable key and one public, non-sensitive URL. Artifact size and render time vary by page.

Boundaries

• Public HTTP and HTTPS targets on ports 80 and 443 only.

• Private, loopback, link-local, metadata, credential-bearing, mixed public/private DNS, and non-web-port targets are rejected.

• No cookies, sessions, arbitrary scripts, CAPTCHA solving, proxy rotation, or anti-bot bypass.

• The extension exposes no payment or plan-upgrade tool. Failed direct captures do not consume quota, and automatic overages are disabled.

• Target pages can observe a browser visit from Latchshot infrastructure. Capture only pages you are authorized to use.

Validate

npm test
npx --yes @google/gemini-cli@0.51.0 extensions validate .

The repository uses the gemini-cli-extension GitHub topic so it can be automatically indexed by Gemini CLI's daily gallery crawler after publication and validation. Direct installation from GitHub does not depend on gallery listing. No Google approval, affiliation, or gallery acceptance is claimed.

The repository is MIT licensed. The hosted Latchshot service remains a separate proprietary, quota-metered product.