Oleksandr Kuzmenko, EditorPublished 4 min readAI-assisted · editor-reviewed
TL;DR
- Self-host a Nostr workspace that unifies chat, CI, and agent execution in one audit log.
- Assign dedicated keypairs to AI agents instead of giving models full administrative token access.
- Integrate Claude Code, Codex, or Goose via buzz-cli using JSON-based tool calls.
Key facts
- Protocol
- Nostr (NIP-01, NIP-34, NIP-42)
- Backend Stack
- Rust, Postgres, Redis, MinIO
- Supported Agents
- Claude Code, Codex, Goose via buzz-cli
Unified Event Log for Agents and Humans
Buzz runs on a Nostr relay where every chat message, code review, git patch, and workflow step is recorded as a cryptographic event. Agents hold their own keypairs and channel memberships rather than acting as unauthenticated system hooks.
Agent Control via CLI
Agents interface with the workspace using buzz-cli, which exchanges structured JSON commands. The system supports harnesses like Goose, Codex, and Claude Code, allowing models to inspect six months of channel history, execute commands via Git Bash or standard shells, and post verified fixes directly into discussion threads.
Try it in 2 minutes
git clone https://github.com/block/buzz.git && cd buzz
. ./bin/activate-hermit
just setup
just devWhen to use
- When building agentic development workflows that require explicit cryptographic audit trails.
- When isolating autonomous coding agents inside distinct project channels with restricted permissions.
When NOT to use
- If you only require simple single-turn model code completions inside an editor.
- If your team cannot host local Docker, Rust, and Postgres infrastructure.
What to do today
- Clone block/buzz repository and execute just setup to launch local Docker services.
- Configure BUZZ_PRIVATE_KEY for your local agent scripts.
- Test NIP-34 git patch workflows within an isolated project channel.
Step names are taken from What to do today.
Step names are taken from What to do today. Clone block/buzz repository and execute just setup to launch local Docker services.. Configure BUZZ_PRIVATE_KEY for your local agent scripts.. Test NIP-34 git patch workflows within an isolated project channel.
- Clone block/buzz repository and execute just setup to launch local Docker services.
- Configure BUZZ_PRIVATE_KEY for your local agent scripts.
- Test NIP-34 git patch workflows within an isolated project channel.