Documentation

Up and running in five minutes

Install the Mac app, pair your phone, point it at your agents. Self-hosting the relay is optional and takes one more command.

01

Install the Mac app

Download the DMG and drag Gallager to Applications. It lives in your menu bar and needs tmux — if tmux is missing, the app walks you through installing it.

02

Connect your agents

Open Settings → Agents. Claude Code and Codex CLI work out of the box; add opencode, pi, omp or any other agent by installing its sidecar plugin.

03

Pair your iPhone

Install the iOS app, then enter the 6-character code shown on your Mac. Keys are exchanged directly between devices — this is the whole setup.

04

Optional: self-host the relay

Point both apps at your own domain in Settings → Remote Access. No license needed.

git clone https://github.com/gpambrozio/Gallager cd Gallager/ClaudeSpyPackage cp .env.example .env && docker compose up -d

Guides

Self-hosting the relay

Docker Compose, TLS via Caddy, and optional APNs push notifications on your own server.

Read →
Agent plugins

How the Claude Code, Codex, opencode, pi and omp integrations hook session events.

Read →
Security model

X25519 pairing, HKDF key derivation, and what the relay can and can't see.

Read →
Push notifications

When they fire, how badges aggregate, and delivering them through a self-hosted relay.

Read →
Multi-pane layouts

Splitting and resizing on the Mac, live mirroring on iPhone, and per-project persistence.

Read →
The gallager CLI

Script sessions, panes and notifications from the shell — everything the app does, from your terminal.

Read →
Token & cost meter

Live per-session tokens, cost and latency from each agent's telemetry — zero setup for Claude Code.

Read →
File & git browser

Review agent diffs beside the terminal: file tree, content search, and a full git workbench.

Read →
The prompt editor (Ctrl-G)

Open long prompts in a real editor overlay instead of the terminal input line.

Read →
Troubleshooting

Pairing issues, connection problems, missing notifications, and sleep.

Read →