buzz-cli skill: stale "users set-presence is broken" gotcha (SKILL.md line 125)
- Dominant language
- Rust
- Stars
- 32.7k
- Forks
- 4.3k
- Avg merge
- 1d 13h
- Merged PRs (30d)
- 253
Description
## Summary
The skill file shipped to Nest-managed agents (`desktop/src-tauri/src/managed_agents/nest_skill.md`, installed as `.agents/skills/buzz-cli/SKILL.md`, frontmatter `version: 1`, `.nest-agents-version` 5) still lists under *Gotchas*, item 2 (line 125):
> 2. **`users set-presence` is broken** — sends ephemeral kind:20001 via HTTP POST; relay rejects ephemeral kinds over HTTP. Will fail until WebSocket support is added.
The command works. The underlying bug was fixed by #876 (merged 2026-06-05, "publish ephemeral events over WebSocket via sprout-ws-client"); the gotcha was never removed.
## Evidence (2026-09-14, self-hosted relay `wss://labtop.tail8e3018.ts.net`)
```
$ buzz users set-presence --status online
{"accepted":true,"event_id":"426c59c703ec15a270395ab9df4eaa9802283a17ef5e515fa962e90449febb1b","message":""}
$ buzz users presence --pubkeys ,,
[{"pubkey":"8130...bf38","status":"online"},{"pubkey":"5908...3986b","status":"online"},{"pubkey":"6c08...1e3f","status":"online"}]
```
## Impact
An agent that follows the skill text never sets its presence and is missing from the availability list, which is exactly where the owner looks to see who is reachable.
## Why not a local fix
The file comes with the Nest package and is overwritten on the next upgrade; a local edit does not survive.
## Ask
Remove gotcha item 2 (or replace it with a note that `set-presence` publishes over WebSocket since #876).
Searched before filing: `set-presence`, `presence`, `kind:20001`, `SKILL.md`, `"set-presence is broken"` — presence tickets exist (#7138, #3795, #7295, …), none about this line.
Contributor guide
Research direction
Start with desktop/src-tauri/src/managed_agents/nest_skill.md and verify the installed .agents/skills/buzz-cli/SKILL.md item 2 against #876. Done means the stale “users set-presence is broken” gotcha is removed or replaced with the WebSocket note, with no remaining stale reference.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- cli, documentation
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Active
- Clarity
- Clearly specified
- Newbie friendliness
- 92/100