Setup guide · Linux

Set up Beeplane
on Linux.

Run the Beeplane daemon on your Linux box, confirm your sessions appear, and pair your phone — same workspace as Mac.

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 daemon

Install Beeplane on your Linux machine. The daemon starts watching agent sessions across your projects.

02

Confirm sessions

Check the workspace list shows your running sessions with live status.

03

Pair your phone

Same Wi-Fi, QR code or pasted token — identical pairing on iPhone and Android.

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

Which distributions are supported?

Any modern distribution that runs the Beeplane daemon alongside your agent CLIs.

Q2

Can Linux and Mac share one workspace?

Yes — sessions from every connected machine appear together.

Q3

No sessions showing?

Start an agent session on the Linux box first. The daemon lists sessions on its own machine only.

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