BrewPing Documentation

A local-first remote control for the AI coding agents already running on your own computer.

Download the disk image, drag BrewPing into Applications, and start it from the menu bar.

Run the NSIS installer, walk through the first-run wizard, and BrewPing lives in the system tray.

iPhone, Apple Watch and Android requirements, install steps, and the permissions each one asks for.

Exchange a 6-digit code once to get a long-lived token. Everything except pairing and status requires it.

The main window, sidebar, terminal dock and settings, plus menu bar controls, the CLI and ~/.brewping.

Sidebar, composer toolbar, terminal dock, settings sections and environment setup.

Six preset providers, a loopback-only proxy that injects real keys, and CLI takeover.

Tell the agent which folder to work in — from the desktop app or from your phone.

Add your computer, send a task, read the result — and do it from your wrist.

Discover your computer over NSD, pair it, and drive conversations from your phone.

How a message becomes a task, the six states it passes through, and the three approval modes.

The six brewping subcommands, their timeouts and exit codes.

Every endpoint, which ones are public, and what write requests must carry.

The failure modes you are most likely to hit, and the exact thing to check for each.

What leaves your machine (almost nothing), how the channel is protected, and the risk you should know about.