botbus-io / botbus-protocol

BotBus Protocol 
 Your AI agents, anywhere you go. 
 Follow the coding agents running on your computer from your phone and watch. 
 Approve requests, reply, start tasks, and open what they built.
 Website ·
 Download BotBus ·
 App Store ·
 Security ·
 Connect your agent ·
 简体中文 
## The BotBus app
BotBus connects the AI coding agents on your computer to your phone and watch. Your agents keep running beside your repositories, tools and credentials while you check progress and act on their requests from anywhere.
- **Keep every session in view.** Tasks are grouped by computer and project, including sessions started in your own terminal or IDE.
- **Approve and keep going.** Approve or deny commands, answer questions, follow up, interrupt, and start new tasks from your phone or Apple Watch.
- **Open the results.** Receive screenshots, videos, documents and links, preview dev-server pages, and review working changes on your phone.
- **Reach your computer.** Browse files and use a terminal from your phone. On macOS, you can also open the desktop and send clicks and keystrokes when a task needs your help.
- **Pair your devices.** Connect multiple computers and phones; your Apple Watch receives pairing from your iPhone and then connects independently.
- **Keep content private.** Conversations, commands, artifacts, notification text and remote-control traffic are end-to-end encrypted. The relay forwards ciphertext; developer web previews are a separate proxy and are not end-to-end encrypted.
Built-in integrations include Codex, Claude Code, Hermes, Pi, OpenClaw and DeepSeek Harness. BotBus also supports agents that implement the Agent Client Protocol (ACP); see the agent connection guide for availability and setup. Actions depend on connector support, task state and whether your computer is online.
## Download and get started
| Platform | Download / install | Requirements and status |
|---|---|---|
| macOS | Download the latest DMG | macOS 26 or later; Apple Silicon and Intel. Signed and notarized menu bar app. |
| Linux | Install guide | Available for x86_64 and aarch64; with or without systemd. |
| iPhone, iPad + Apple Watch | Download on the App Store | iOS 26 / watchOS 26 or later. The watch app comes with the iPhone app. |
| Android | Download the APK | Android 8.0 or later. The website links to the current APK. |
| Windows | Release status | In development; not yet available to download. |
1. Install BotBus on your computer and the companion app on your phone.
2. Open pairing from the Mac menu bar, or run `botbus pair` on Linux, and scan the QR code with your phone.
3. Open your tasks on the phone. On Apple Watch, pairing syncs automatically from your iPhone.
See botbus.io for current releases and setup instructions.
## What is in this repository?
This repository is the public half of the BotBus computer app: the stable wire contract the mobile apps decode, and the Swift code that adapts each upstream agent (Codex, Claude Code, Hermes, Pi, OpenClaw,