BrewPing

English | 简体中文

A local-network remote control for coding agents running on your own computer.

BrewPing lets you monitor, control, and approve coding-agent tasks running on your own Mac or Windows computer — from your iPhone, Apple Watch, or Android phone. Pair once over your local network, and the work stays on your machine: no account, no analytics, no server of ours in the path.

Your agents, your models, your machine — driven from your phone, on your own network.

⬇️ Download

The macOS and Windows builds on the release page are the same code as this repository at tag v1.0.0. Which surfaces are shipped, in-repo-but-unreleased, or not started is spelled out in Platform status — and nowhere else.

📸 Screenshots

What BrewPing is — and what it is not

BrewPing is not a coding agent. It does not write code, it does not call a model on your behalf, and it does not replace the tools you already use.

It is a remote interface for coding agents that are already running on your own computer. The agent does the actual work; BrewPing is how you watch it, steer it, and approve what it is about to do — without sitting at that machine.

Coding agent   →  does the actual coding work   (OpenCode / Claude Code / Codex CLI / pi)
BrewPing       →  lets you monitor, control, and approve that work remotely

BrewPing ships no agent and no model. It detects the CLI agents you installed, reads the configuration they already have, and drives them exactly as they are — your subscriptions, credentials, and settings stay where they are.

🎯 Who is it for?

• You run a coding agent — OpenCode, Claude Code, Codex CLI, or pi — on a Mac or Windows machine, and you want to kick off work, check progress, or approve a risky command without sitting at that machine.
• You want that from your phone or watch: one hand, one glance, no remote desktop.
• You care that your code, prompts, and agent output stay on your own machines.

Not for you if: you don't have any of those CLI agents installed (BrewPing drives them, it does not replace them), or you are looking for a hosted coding agent that runs in the cloud.

🤔 Why BrewPing instead of SSH, remote desktop, or a hosted agent?

✨ Features

• Remote monitoring — live agent status and streaming output, rendered as Markdown, on your phone or watch.
• Remote control — start and stop sessions, send instructions, switch the active agent and model.
• Approval gate — dangerous commands are held until you approve them; a pending request times out as denied, never as approved.
• Local-first — commands and output travel only between your phone and the computer you paired.
• No account, no sign-up — pairing is a one-time 6-digit code, not a login.
• Automatic discovery — Bonjour/mDNS finds computers on the current Wi-Fi; manual host and port is always available as a fallback.
• Four agents, one interface — OpenCode, Claude Code, Codex CLI, and pi, with per-agent model switching (details).
• iPhone, Apple Watch, Android — the Watch app takes voice-dictated instructions and shows the reply; the Android app shares the same flow.
• Conversations and working folders — conversations are bound to a folder, so file operations happen where the conversation lives. Agent, model, and approval level are set per conversation.
• Multi-device — pair several computers and switch between them from the device bar.
• Bilingual UI — English and Simplified Chinese, switchable in-app without a restart.

🔄 How it works

┌──────────────────────────────────────┐
│          Your Mac / Windows          │
│                                      │
│   Coding agent                       │
│   OpenCode · Claude Code ·           │
│   Codex CLI · pi                     │
│              │                       │
│        BrewPing Desktop              │
└──────────────┼───────────────────────┘
               │   local network
               │   HTTP API + Bonjour/mDNS discovery
        ┌──────┴───────┐
        │              │
     iPhone        Apple Watch
        │              │
   monitor · control · approve

1. Your agent runs on your computer, exactly as it does today.
2. BrewPing Desktop sits next to it, exposes a local HTTP API, and supervises the agent process.
3. Your phone or watch discovers the computer on the same network and pairs with a one-time code.
4. From there you monitor, instruct, and approve — the network never leaves your LAN.

📦 Platform status

"Built" means the artifact can be produced from this repository. It does not mean it is available to the public. Anything not listed as Available above is not shipped.

🧠 Supported coding agents

BrewPing drives CLI agents you installed yourself. It never bundles or redistributes them, and it never replaces their configuration — it reads what is there.

Install the ones you want to use:

# OpenCode
curl -fsSL https://get.opencode.ai | sh

# Claude Code
npm install -g @anthropic-ai/claude-code

# Codex CLI
npm install -g @openai/codex

# pi
npm install -g @earendil-works/pi-coding-agent

Product names and trademarks belong to their respective owners — see TRADEMARKS.md.

🚀 Getting started

1. Install BrewPing Desktop

• macOS — download the DMG from the GitHub Release (or the download page), open it, and drag BrewPing Desktop into Applications. It is signed, notarized, and stapled, so Gatekeeper opens it without warnings.

• Windows — download setup.exe or the .msi from the same release and install it.

• From source (macOS):

  git clone https://github.com/banmu123/BrewPing.git
  cd BrewPing
  ./build-app.sh                          # produces build/Br