docs(buzz-acp): correct agent key generation instructions#2875
Merged
Conversation
wpfleger96
approved these changes
Jul 25, 2026
wpfleger96
left a comment
wpfleger96
left a comment
Member
There was a problem hiding this comment.
Thank you for the contribution! Your commit just needs a DCO sign-off then this can merge!
The README instructs `buzz-admin mint-token --name --scopes`, which is not a subcommand of buzz-admin. Following the quickstart fails at the first step of setting up an agent identity. Replace it with the actual flow: `generate-key` to mint the keypair, then `add-member` to register the agent's pubkey on the relay. Also note that `add-member` publishes a kind:13534 event and therefore requires BUZZ_RELAY_PRIVATE_KEY to be set on the relay, which is commented out in .env.example by default and is easy to miss. Also corrects the described output: `generate-key` prints a hex keypair, not an `nsec1...` key plus an API token. Signed-off-by: mager <andrew.mager@gmail.com>
mager
force-pushed
the
fix-acp-readme-keygen
branch
from
July 25, 2026 20:51
82661f0 to
79ddae1
Compare
Contributor
Author
|
@wpfleger96 Thanks! DCO check is passing now, will merge when all green. |
Contributor
Author
|
All green now — DCO passing and CI clean. I don't have merge rights here, so this needs a maintainer to land it whenever convenient. |
johnmatthewtennant
added a commit
to johnmatthewtennant/buzz
that referenced
this pull request
Jul 26, 2026
…unity-policy-fetch * origin/main: Fix formatting in README.md diagram (block#2284) fix(desktop): make Linux AppImage GStreamer work on non-Debian distros (block#2176) refactor(desktop): remove Agent directory section from Agents page (block#2290) fix(desktop): enable arboard Wayland backend so Linux copies reach the Wayland clipboard (block#2904) fix(desktop): supervise and re-arm relay-mesh runtime (block#2823) fix(agents): run live Databricks discovery instead of the fallback list (block#2890) fix(desktop): retire prepend mode on every reader wheel (block#2913) fix(desktop): consolidate prepend scroll correction (block#2855) docs(buzz-acp): correct agent key generation instructions (block#2875) fix(desktop): track concurrent agent turns up to the harness maximum (block#2882) docs(contributing): trim to goose-scale minimal intake surface (block#2780) fix(relay): preserve reconnect backoff (block#2759)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
crates/buzz-acp/README.mdtells you to generate an agent identity with:mint-tokenis not a subcommand ofbuzz-admin— the available commands areadd-member,remove-member,list-members,generate-key,migrate,product-feedback, andreconcile-channels. Following the agent quickstartfails at the first step.
Change
Documents the flow that works:
generate-keyto mint the keypairadd-memberto register the agent's pubkey on the relayAlso notes that
add-memberpublishes a kind:13534 membership event and sorequires
BUZZ_RELAY_PRIVATE_KEYto be set on the relay. It is commented outin
.env.example, and the relay must be restarted after setting it — theerror surfaces at
add-membertime rather than at relay startup, so it iseasy to hit.
Corrects the described output as well:
generate-keyprints a hex keypair,not an
nsec1...key plus an API token.Verification
Found while setting up a self-hosted relay and wiring an agent through
buzz-acpwithclaude-agent-acp. Both documented commands were run againsta local relay; the agent authenticates and round-trips signed messages.
Docs only — no code paths touched.
🤖 Generated with Claude Code