Beep

Run coding agents on every machine you own, from one desktop or your phone.

macOS · Windows · Linux
Website · Docs · Getting started

Welcome to Beep, over a painted sunrise

## What it does - **Peer to peer.** Desktops, phones and `beep-node`s form a signed mesh over [iroh](https://github.com/n0-computer/iroh): QUIC, encrypted end to end. No Beep server, no cloud, no account. - **Your agents, your subscriptions.** Start Claude Code, Codex and other agents on any machine, with that machine's sign-in, files and tools. - **Projects follow you.** Git commits move between machines; non-Git folders sync as files. Coding agent skills can sync too. - **One board.** Sessions, terminals, reviews, pull requests and issues from every machine in one place. - **Every platform.** A [Tauri](https://tauri.app) app for macOS, Windows and Linux, the same app on iOS and Android, and `beep-node` for servers and containers.

An agent session with its files, changes and running commands

Read [how Beep works](https://beep.flashmind.com/docs/architecture/) for the mesh, tickets and sync in detail. ## Build from source ```sh just run # desktop app (quit Beep first) just desktop-build # build it just desktop-check # type checks and tests ``` Normal builds include the complete app for their platform. Plugin TypeScript is compiled before installation, not inside the app. Add a machine from the desktop: it gives you a one-use ticket for `beep-node`. ## beep-node in Docker Each node release publishes a small image (amd64 and arm64) with the static binary, git, curl, a shell and CA certificates. It runs as uid 1000 and keeps its key and mesh in `/data`. ```sh docker run -d --restart unless-stopped --hostname build-box \ -e BEEP_TICKET=... -v beep-node:/data registry.example/beep-node ``` - The ticket is used once; later starts reuse `/data`. - The host name is the machine's name in the mesh. - `BEEP_NODE_WORKSPACE` shares a folder with the rest of the mesh. - Allow UDP 47120 through the firewall, or add `-p 47120:47120/udp`. - Upgrade by pulling a newer tag. No coding agents are installed: build `FROM` this image and add the ones you use. ## Phones The phone app is the desktop app built for iOS and Android. It pairs with a desktop's phone code and joins the mesh as an observer. ```sh just ios-sim-run # iPhone simulator just ios-run # connected iPhone just android-run # connected device or emulator ``` iOS needs Xcode and `rustup target add aarch64-apple-ios aarch64-apple-ios-sim`. Android needs the SDK and NDK with `ANDROID_HOME` and `NDK_HOME` set, and `rustup target add aarch64-linux-android`. ## Windows Windows x64 needs the WebView2 runtime. With Rust's MSVC toolchain, Visual Studio C++ Build Tools and Node installed, `scripts/build-desktop-windows.ps1` builds the NSIS installer. On Linux, `scripts/build-desktop-windows.sh` builds a portable executable with cargo-xwin. Ctrl+Alt+Space opens the bar; desktop control is unavailable. ## Report server `beep-server` only receives the apps' problem reports. ```sh cp config.example.toml config.toml cargo run -p beep-server -- config.toml ``` Reports go to `[reports.r2]`, or to `[reports].folder` in development. `deploy/compose.yaml` runs it on loopback port 47122 behind a TLS proxy. `just reports`, `just report ` and `just report-solved ` manage them. ## Releases `just patch ` and `just minor ` bump `desktop`, `beep-node`, `android`, `ios` or `all`, freeze their changelogs, commit and push main with the tags. `just release [apps]` does a patch bump; `--dry-run` checks versions. Tags make CI build and publish each app. `just server-release ` tags the server. ## Layout ```text crates/proto/ wire types and framing crates/mesh/ signed membership, tickets and replicated state crates/fleet/ desktop projects, credentials and settings crates/projects/ project code shared by node and desktop crates/node/ beep-node: agents, files, sync and processes crates/report/ problem reports crates/server/ beep-server apps/desktop/ Tauri app for macOS, Windows, iOS and Android deploy/ container entrypoints and compose file scripts/ build helpers ```