Install
Pounce is two halves: the phone app (the remote) and the Bridge (the part on your computer that hosts your agents). Install one of each.
iPhone
Section titled “iPhone”Download Pounce on the App Store. Requires iOS 16 or later.
Android
Section titled “Android”In testing on Google Play now — public release soon. The changelog will announce it the day it’s out.
Computer
Section titled “Computer”Not sure which? Let it decide
Section titled “Not sure which? Let it decide”npx use-pounce configureOne command on any machine with Node.js. It works out what the machine is — OS, chip, whether there’s a screen, whether you’re on the other end of an SSH connection — then offers you the desktop app or a Bridge that starts at login, and installs the one you pick. Everything below is the same thing done by hand.
macOS — the desktop app
Section titled “macOS — the desktop app”Download Pounce.dmg
— signed and notarized, macOS 14+ on Apple Silicon. Open it, drag Pounce to
Applications, launch. The full Pounce UI runs on your Mac with the Bridge built
in, and the pairing QR is right in the window.
Intel Macs are not supported by the desktop app — use npx use-pounce below
instead.
The app keeps itself up to date automatically.
Windows · Linux — the headless Bridge
Section titled “Windows · Linux — the headless Bridge”Download pounce-bridge.zip from the
latest release, unzip,
and run install.ps1 (Windows) or install.sh (Linux). Needs Node.js on the
machine. It starts the Bridge and prints the pairing QR.
Any terminal — npx use-pounce
Section titled “Any terminal — npx use-pounce”npx use-pounceOne command on any machine with Node.js — macOS, Windows, or Linux. It starts the Bridge in the background, prints a QR in the terminal, and waits for your scan. The Bridge keeps running after you close the terminal.
Works over SSH too, so it’s the easiest way to pair a remote server — see Away from home.
Installing globally makes the command just pounce:
npm i -g use-pouncepounceThe CLI reference covers every subcommand and flag.