Blackbird

Blackbird: Agents at your desk. Answers from your pocket.

Claude Code, Codex and any ACP agent keep working on your own machines. Blackbird tells you the moment one needs you, and you approve, reply or review from your iPhone or your Mac.

curl -fsSL https://blackbird.codes/install | sh

Then blackbird setup, and scan the code with your iPhone.

Works with

  • Claude
  • Codex
  • Cursor
  • GitHub Copilot
  • Grok Build
  • OpenCode
  • Google Antigravity
  • Hermes Agent
  • + any ACP agent
Agents

Works with the agents you already use

  • Claude
  • Codex
  • Cursor
  • GitHub Copilot
  • Grok Build
  • OpenCode
  • Google Antigravity
  • Hermes Agent
  • + any ACP agent
README.txtRead Me

BLACKBIRD

A server runs your coding agents on your own Mac or Linux machines, under your own logins. The iPhone and Mac apps show what needs you and let you answer, steer and review.

Your sessions stay on your machines. No analytics, no cookies.

Needs: an iPhone with iOS 26 or later, or a Mac with macOS 27 or later, and a Mac (arm64) or Linux (x86_64, arm64) machine with Node 22, git and Tailscale for the server.

License: AGPL-3.0. Read every line.

app.bmp - Image Viewerapp.png

One session, on every screen you carry.

Start a task at the desk, answer it from the iPhone, review it on the Mac. The session is the same everywhere.

Blackbird on an iPhone, a Mac and a foldable phone: Claude asks to run git push, with Deny, Always Allow and Allow Once Open in Preview
While you are away - PropertiesWhile you are away Info

The work keeps going. You step in when it asks.

Know the moment it needs you

A permission, a question, a finished task: each arrives as a notification with the session, the project and the machine.

Answer in one tap

Allow, deny, or tell the agent what to do instead, from the iPhone or the Mac.

Every machine, one list

One server per Mac or Linux box. Sessions from all of them, sorted by what needs you.

Review before it ships

Diffs, files, pull requests and the session's terminal, from the couch.

Watch it from the Lock Screen

Live Activities follow the work in progress without opening the app.

Your code stays on your machines

The apps reach your host over your tailnet, encrypted by Tailscale. A relay, when you start a host with one, is encrypted end to end and keeps no content. Blackbird sends no analytics and no crash data.

Your code stays on your machinesEncrypted on the wayNo analytics, no crash data

Blackbird Setup WizardBlackbird Setup Assistant

Paired before your coffee cools.

  1. Install the server

    On a Mac (arm64) or Linux (x86_64, arm64) machine with Node 22, git and Tailscale. The installer checks the archive against its checksums.

    curl -fsSL https://blackbird.codes/install | sh

    Downloading blackbird 0.1.1 for darwin-arm64

    Verified against SHA256SUMS

    Installed ~/.local/bin/blackbird

  2. Run setup

    It checks the service, Tailscale, your agents and notifications, and offers to fix what it can.

    blackbird setup

    Service running

    tailscale serve on studio.tail1234.ts.net

    Agents: claude, codex, cursor

    Notifications ready

  3. Scan the code

    Setup ends with a QR code: open Blackbird on your iPhone and scan it. On the server's own Mac the Mac app needs no pairing.

    blackbird setup

    Service, Tailscale, agents and notifications ready

    Waiting for your iPhone

Step 1 of 3
blackbird Propertiesblackbird Info

Open source. Read every line.


Type:
Server, iPhone app and Mac app
Location:
github.com/xsmyile/blackbird
License:
AGPL-3.0
Contains:
Every line: build it yourself, audit what leaves your machine, or send a fix

Attributes:

Let the agents work. Keep your evening.

curl -fsSL https://blackbird.codes/install | sh
Shut Down BirdOS
What should BirdOS do?
app.bmp - Previewapp.png
Blackbird on an iPhone, a Mac and a foldable phone: Claude asks to run git push, with Deny, Always Allow and Allow Once