pocket-veto

Pocket Veto — Development skill for Claude Code

Development community

Local-only, Bluetooth-mediated approval gate and live progress dashboard for.

How to install Pocket Veto

This entry records only its repository, not the path inside it, so there is no exact command to give. Open pocket-veto/pocket-veto and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Pocket Veto does

Local-only, Bluetooth-mediated approval gate and live progress dashboard for.

Alternatives in Development

Claude Desktop Buddy — Reference and an example for the Bluetooth API for makers in Claude Cowork & Claude Code Desktop 2.5k ★
Claude Usage — A local dashboard for tracking your Claude Code token usage, costs, and session history 864 ★
Dario — A local OpenAI- and Anthropic-compatible proxy that brings your Claude Pro/Max subscription to Cursor, Cline 485 ★

README

pocket-veto

Local-only, Bluetooth-mediated approval gate and live progress dashboard for AI coding agents.

Why

You are away from the PC, screen off or busy. Your AI coding agents want to run risky tools (shell commands, file writes, MCP calls) and you want to approve or deny them from your phone. PocketVeto does that over Bluetooth Classic, with no internet and no LAN routing, so it keeps working under WiFi AP isolation. The same phone also shows a live dashboard of every running agent so you can see what they are up to without watching a terminal.

Status

v1. Supported on **Windows**, **native Linux**, and **Linux devcontainers** (via a host-sidecar pattern). macOS Bluetooth is deferred to post-v1; the non-Bluetooth parts of the binary still compile and run on macOS, so a Mac can host agents that gate against a Linux/Windows server.

Quickstart

**Install the binary** on the host machine that owns the Bluetooth radio:
```
curl -fsSL https://github.com/pocket-veto/pocket-veto/releases/latest/download/install.sh | sh
```
See [docs/setup.md](docs/setup.md) for Windows, build-from-source, and devcontainer variants.
**Initialize** configuration, hook installs, and the bearer token:
```
pocket-veto init
```
This pairs Bluetooth (or lets you skip it for a devcontainer-only setup), writes `~/.pocket-veto/config.toml`, installs hooks into `.cursor/hooks.json` and `.claude/settings.json`, and registers the server as a system service.
**Start the server** (or reboot; the service starts automatically):
```
pocket-veto serve
```
**Install the Android app** by sideloading the APK from the latest GitHub release (or build it with `./gradlew assembleDebug` from `android/`), pair the phone with the PC if you have not already, and grant the runtime permissions. The dashboard and approval notifications appear automatically.