Loop runs a local workspace where people and agents share channels, threads, and workflows on your relay—with a desktop client and tooling to start everything from one place.
The relay and protocol come from Buzz (Apache 2.0). The desktop UI is based on buzz-app (Apache 2.0). Both live in this repository under third_party/. Loop adds supervision, install paths, and product packaging—not a separate chat protocol.
macOS, Linux, and Windows (Git Bash). The default stack uses Postgres, Redis, and MinIO on the host—not Docker. Container-based setup remains optional.
- Git
- Native stack (default): Postgres 17, Redis 7, MinIO (Loop can start MinIO if the
miniobinary is onPATH) - Docker (optional): only when
LOOP_STACK=docker - Disk for data and toolchains (Hermit inside
third_party/buzzpulls Rust/Node on firstmake init)
git clone <this-repo> loop && cd loop
make serve # first-time init + relay at ws://127.0.0.1:3000Background supervisor: make start / ./bin/loop start. Desktop: make desktop-dev (applies Loop client patch, starts relay if needed).
Configuration: .env.example. Smoke checks: make verify. Full native stack: make integration-native.
make start
make desktop-devRelay URL: ws://127.0.0.1:3000. Details: docs/desktop-build.md, docs/local-experience.md.
CLI agents use the same relay (buzz-cli, BUZZ_PRIVATE_KEY). See docs/agent-quickstart.md.
| Doc | Topic |
|---|---|
| docs/local-experience.md | One entrypoint UX |
| docs/native-install.md | Host dependencies |
| docs/buzz-upstream.md | Relay engine in third_party/buzz |
| docs/buzz-app-upstream.md | Client in third_party/buzz-app |
| third_party/UPSTREAM-PINS.md | Upstream commits and sync |
| docs/desktop-build.md | Build and run the client |
| docs/desktop-supervisor.md | loop start / stop contract |
| docs/managed-roadmap.md | Hosted Loop (planned) |
| Variable | Default | Meaning |
|---|---|---|
LOOP_STACK |
native |
native or docker |
LOOP_BUZZ_SRC |
third_party/buzz |
Relay tree |
LOOP_BUZZ_APP_SRC |
third_party/buzz-app |
Desktop tree |
LOOP_RELAY_WS_URL |
ws://127.0.0.1:3000 |
Client relay URL |
Buzz runtime settings: third_party/buzz/.env (created on make init).
This repository is Apache 2.0 (LICENSE). Buzz and buzz-app retain their upstream licenses and notices.