Gemini CLI,pointed at the right element.

PulseDev runs Gemini CLI in ACP mode, sends it the element you clicked and what you want changed, and shows Gemini’s work next to the element until you approve the diff.

Download for macOS Setup steps

macOS 13 or later. Free plan includes one agent of your choice.

How does PulseDev run Gemini CLI?

It talks to the agent over the Agent Client Protocol (ACP), the same open protocol editors use to drive agents.

PulseDev starts gemini --acp in your project folder and opens an ACP session. The prompt carries your note plus the element context the widget captured: selector, markup, matched styles, console errors, failed requests and a screenshot.

Gemini’s messages and tool calls stream into the widget. When Gemini asks for permission to do something, the request appears in the widget with Gemini’s own options, and the run waits for your answer. Turn on Auto-apply and PulseDev answers with allow instead.

Replies to a finished fix load the same ACP session, so Gemini keeps what it learned about your code.

what PulseDev runs

$gemini --acp

PulseDev talks to Gemini CLI over the Agent Client Protocol on stdin and stdout.

What does a fix with Gemini CLI look like?

The same loop for every agent. The widget on your page talks only to the PulseDev server on your machine.

Point. Turn on Inspect in the widget and click the element. Shift-click to add more.
Describe. Write the change in plain words and pick Gemini CLI as the agent. The widget sends your note with the page URL, the element’s selector and markup, styles, recent console errors and failed requests, a page outline and a screenshot of the element.
Watch. PulseDev starts Gemini CLI in your project folder. Its reads, searches and commands show up next to the element as they happen.
Approve. In review mode PulseDev asks the agent to propose a diff rather than edit files. Approve applies the proposal, Reject discards it, or reply to ask for another pass in the same session.

Runs are queued one at a time per project. Review the applied changes in your editor before committing them with your usual git workflow.

How do I set up Gemini CLI with PulseDev?

You need the agent CLI installed and signed in. PulseDev finds it on your PATH and in the usual install folders. Settings › Agents has detection and custom-path controls for Claude Code, Codex and Gemini CLI.

Install PulseDev. Download the app, add your project folder and click Set up project. That adds the widget script tag (or the Vite plugin) to your dev site.
Install Gemini CLI and sign in. Install the gemini CLI and run it once to sign in. PulseDev uses that login.
Check Settings › Agents. Gemini CLI should show as found with its version. Set a custom path there if PulseDev can’t find it.
Choose it per fix. Pick Gemini CLI as your default agent, or pick it in the widget when you send a fix.
Optional: connect your editor. Connect editor (MCP) writes the PulseDev MCP server into .mcp.json (Claude Code), .cursor/mcp.json and .vscode/mcp.json, so your editor can list, read and close annotations.

.mcp.json (written by Connect editor)

{
  "mcpServers": {
    "pulsedev": {
      "type": "http",
      "url": "http://localhost:3899/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

The app fills in your project’s port and token. The MCP server offers four tools: list_annotations, get_annotation, update_annotation_status and get_element_context.

Gemini CLI and PulseDev: common questions

Why ACP and not plain output?: The Agent Client Protocol gives PulseDev structured messages, tool calls and permission requests. That’s what lets Gemini ask you before it acts, right in the widget.
Does my code go to PulseDev?: No. Gemini CLI sends prompts and file contents to Google under Google’s terms, as it does in your terminal. PulseDev runs locally and never receives your code or prompts.
Which Gemini CLI version do I need?: One that supports the --acp flag, which is what PulseDev runs. Settings › Agents shows the version PulseDev found.

Gemini CLI on GitHub How PulseDev handles your code

Other agents PulseDev runs

Keep Gemini CLI.Add a pointer.

Download for macOS

Free to start. No credit card.