beep
Health Warn
- License — License: MPL-2.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Fail
- rm -rf — Recursive force deletion command in .github/workflows/ios.yml
- rm -rf — Recursive force deletion command in .github/workflows/node.yml
- process.env — Environment variable access in apps/desktop/build.mjs
- process.env — Environment variable access in apps/desktop/playwright.config.ts
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Lightweight ADE build for the future of software. Connect your machines P2P.
Beep
Run coding agents on every machine you own, from one desktop or your phone.
macOS ·
Windows ·
Linux
Website ·
Docs ·
Getting started
What it does
- Peer to peer. Desktops, phones and
beep-nodes form a signed mesh over
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 app for macOS, Windows and
Linux, the same app on iOS and Android, andbeep-nodefor servers and
containers.
Read how Beep works for the
mesh, tickets and sync in detail.
Build from source
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.
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_WORKSPACEshares 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
FROMthis 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.
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, andrustup 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.
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 <id> and just report-solved <id> manage them.
Releases
just patch <apps> and just minor <apps> 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 <version> tags
the server.
Layout
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
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found