beep

skill
Security Audit
Fail
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.

SUMMARY

Lightweight ADE build for the future of software. Connect your machines P2P.

README.md

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-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, and beep-node for servers and
    containers.

An agent session with its files, changes and running commands

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_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.

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.

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)

No results found