Setup guide · Mac

Set up Beeplane
on your Mac.

Install the Mac app, let the background daemon find your agent sessions, and pair your phone. Two minutes, no configuration.

Explore the iPhone app → See how it works →
Beeplane mobile app showing project activity
Works with Claude Codex OpenCode Any agent on Mac or Linux

Setup in three steps

01

Install the Mac app

Download Beeplane for macOS and open it. The background daemon starts watching your agent sessions across projects immediately.

02

Check your sessions appear

Open the workspace and confirm your running Claude, Codex, or OpenCode sessions are listed with live status.

03

Pair your phone

On the same Wi-Fi, scan the QR code or paste the pairing token from the iPhone or Android app.

What you get

Live session view

See every running agent session across all your projects — what it's working on, how long it's been active, and whether it needs input.

Send messages

Reply to a stuck agent, redirect the work, or give new instructions — straight from your phone. No need to open your laptop.

Full transcripts

Read the complete session transcript — every message, tool use, and response — so you always know exactly what the agent did.

Token usage

Track context size, output tokens, and cache activity per session. Know when a session is getting expensive before it matters.

Local network or relay

Connect directly over Wi-Fi when you're home, or through an encrypted relay when you're out. No VPN required, no cloud storage.

Private by design

Your session transcripts and source code never leave your devices. The relay only passes encrypted request payloads — it never stores them.

Explore Beeplane

AI coding agent workflows, by platform and task.

Whether you run Claude Code, Codex, or OpenCode, Beeplane keeps the session on your Mac or Linux machine while giving you a clear way to monitor progress and reply from your phone. Start with the workflow that matches how you build.

Set up in two minutes. Works everywhere.

01

Install Beeplane on your machine

Install the Beeplane Mac app or Linux daemon. It watches your agent sessions and makes them available to your paired phone.

02

Pair your phone

On the same Wi-Fi network, scan the QR code or paste the pairing token. The iPhone or Android app connects directly to your Mac or Linux machine.

03

Use the relay away from home

Enable the encrypted relay to connect from any network. Your machine stays the source of truth and the relay does not store session data.

04

Monitor and reply

Check session progress from your phone, answer when an agent needs direction, and continue from the full transcript.

◆ Coming soon

Just say it. The right agent picks it up.

Speak a task — Beeplane figures out which session to route it to based on what each agent already knows. No need to remember which project lives where.

Questions, answered.

Q1

The daemon runs but no sessions appear?

Start an agent session in any project on your Mac, then refresh the workspace list. Only sessions on the same machine are visible.

Q2

Do I need an account or API key?

No. Pairing uses a local token shown by the Mac app — no account, no cloud signup.

Q3

Does setup change my agent workflow?

No. The daemon only observes sessions. Your terminals, IDEs, and agents keep working exactly as before.

No cloud storage
Encrypted relay
Local-first
No account required
Open relay source

Your agents are already working.
Now you can be anywhere.

Free to download. Works with Claude Code, Codex, OpenCode, and other agents on macOS or Linux.

iPhone app details Get it on Google Play Download for Mac
Share on X → Copy link