What do you want to do?
4 use cases
-
Approve Codex and Claude Code requests from your phone
Pair your computer with your phone so you can approve commands and answer agent questions away from your desk.
View prompt
Using the BotBus setup described in botbus-io/botbus-protocol, confirm that the Mac app is paired with <phone name>. Report whether a Codex or Claude Code task on <computer name> is waiting for a request, and list the request kind and task ID without approving anything.
-
Review agent screenshots, previews and changes on your phone
Open what an agent built, including dev-server pages and working changes, without going back to your desk.
View prompt
Using the BotBus app paired to <computer name>, list the artifacts and dev-server previews attached to task <task ID>. Confirm that each item opens on the phone and report anything that does not load.
-
Pair a Linux machine running agents with your phone
Install BotBus on a Linux computer and pair it so agents on that box can be followed from your phone.
- Botbus Protocol
- Codex
- Claude Code
- Software and DevOps
- Intermediate
View prompt
On the Linux host, run `botbus pair` and report the pairing status. Then list the tasks BotBus sees on that host, grouped by project, and note any host that is offline.
-
Test a BotBus client against the public wire fixtures
Run the Swift and TypeScript checks and the sealed fixtures to confirm a client decodes the protocol correctly.
- Botbus Protocol
- Software and DevOps
- Advanced
View prompt
Clone botbus-io/botbus-protocol, run `swift test` and `npm test`, and report the pass or fail count for each. Then decode every file in protocol-fixtures/ with <your client decoder> and list any fixture it fails to parse.
How to use Botbus Protocol
- Check you have what it needs: A Mac running macOS 26 or later, or a Linux machine (x86_64 or aarch64); An iPhone on iOS 26 or later, or an Android phone on Android 8.0 or later; Codex or Claude Code installed on the computer that will run the tasks.
- Open botbus-io/botbus-protocol on GitHub and read the README and license.
- Download the BotBus app for macOS from the DMG link on botbus.io and install it on your Mac.
- Install the BotBus app on your iPhone from the App Store page linked in the README.
- Open pairing from the Mac menu bar and scan the QR code with your phone.
- Start a Codex or Claude Code task on your computer, either from BotBus or from your own terminal or IDE.
These steps come from our top use case, Approve Codex and Claude Code requests from your phone, which also has a copy-paste agent prompt.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeBotbus Protocol alternatives · Best AI repos for Software and DevOps
About this repo
- Who it is forDevelopers and AI agents who run coding agents on a Mac or Linux machine and want to monitor or approve them from a phone, or who build clients and connectors that speak the BotBus protocol.
- Why it is hot
- LanguageSwift
- Sourcegithub.com/botbus-io/botbus-protocol · Back to Hot repos
Requirements
- A Mac running macOS 26 or later, or a Linux machine (x86_64 or aarch64)
- An iPhone on iOS 26 or later, or an Android phone on Android 8.0 or later
- Codex or Claude Code installed on the computer that will run the tasks
- Xcode 27 on macOS 26 and Node.js 22 if you plan to build or test this repository
Maintain Botbus Protocol? Add the Featured on Deduped badge
Paste this into your README:
[](https://dedupedai.com/use-cases/botbus-io-botbus-protocol/?ref=badge)
Questions about Botbus Protocol
What is Botbus Protocol?
BotBus Protocol is the public wire contract, Swift connector code and test fixtures behind the BotBus apps, which let you follow and approve Codex and Claude Code tasks from your phone and watch. It is an open-source project on GitHub: https://github.com/botbus-io/botbus-protocol.
Who is Botbus Protocol for?
Developers and AI agents who run coding agents on a Mac or Linux machine and want to monitor or approve them from a phone, or who build clients and connectors that speak the BotBus protocol.
What can I do with Botbus Protocol?
4 use cases so far, for example: Approve Codex and Claude Code requests from your phone; Review agent screenshots, previews and changes on your phone; Pair a Linux machine running agents with your phone. Each has steps and a copy-paste agent prompt.
What do I need to run Botbus Protocol?
A Mac running macOS 26 or later, or a Linux machine (x86_64 or aarch64); An iPhone on iOS 26 or later, or an Android phone on Android 8.0 or later; Codex or Claude Code installed on the computer that will run the tasks; Xcode 27 on macOS 26 and Node.js 22 if you plan to build or test this repository.
What are alternatives to Botbus Protocol?
Other hot AI repos in Software and DevOps: Harness2, iFixAi, Orca, Diagram Design, AI Memory.
Is Botbus Protocol safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.