docs(skill): cover topic tail/post + member list + notification list
Adds v1.7.0 (terminal parity) and v1.8.0 (per-topic encryption)
verbs to the bundled claudemesh skill so Claude Code sessions
discover them via the auto-installed SKILL.md instead of the
README-only path.
Sections added:
- topic tail / topic post under the topic block
- member resource (distinct from peer)
- notification resource
- per-topic encryption block — explains v2 ciphertext marker,
re-seal flow, and 404 behaviour
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -52,8 +52,16 @@ claudemesh topic history deploys --limit 50 # fetch back-scroll
|
|||||||
claudemesh topic history deploys --before <msg-id> # paginate older
|
claudemesh topic history deploys --before <msg-id> # paginate older
|
||||||
claudemesh topic read deploys # mark all as read
|
claudemesh topic read deploys # mark all as read
|
||||||
|
|
||||||
# Send to a topic — same `send` verb, target starts with #
|
# Send to a topic — same `send` verb, target starts with # (WS, v1 plaintext)
|
||||||
claudemesh send "#deploys" "rolling out 1.5.1 to staging"
|
claudemesh send "#deploys" "rolling out 1.5.1 to staging"
|
||||||
|
|
||||||
|
# v1.7.0+: live tail in the terminal — backfill last N + then SSE forward.
|
||||||
|
# Decrypts v2 messages on render. Runs a 30s re-seal loop while held.
|
||||||
|
claudemesh topic tail deploys --limit 50
|
||||||
|
|
||||||
|
# v1.8.0+: encrypted REST send (body_version 2). Falls back to v1
|
||||||
|
# automatically for legacy unencrypted topics. --plaintext forces v1.
|
||||||
|
claudemesh topic post deploys "rolling out, cc @Alexis stay around"
|
||||||
```
|
```
|
||||||
|
|
||||||
When to use topics vs groups vs DM:
|
When to use topics vs groups vs DM:
|
||||||
@@ -61,6 +69,34 @@ When to use topics vs groups vs DM:
|
|||||||
- **Group** (`send "@frontend"`) — addresses everyone in a group; ephemeral; for coordinating teams.
|
- **Group** (`send "@frontend"`) — addresses everyone in a group; ephemeral; for coordinating teams.
|
||||||
- **Topic** (`send "#deploys"`) — durable conversation room; for ongoing work threads, incident channels, build-status feeds.
|
- **Topic** (`send "#deploys"`) — durable conversation room; for ongoing work threads, incident channels, build-status feeds.
|
||||||
|
|
||||||
|
### `member` — mesh roster + online state (v1.7.0)
|
||||||
|
|
||||||
|
Distinct from `peer list`: members shows the static roster (every joined member of a mesh, online or not), peers shows the live WS-connected sessions plus REST-active humans.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
claudemesh member list # everyone, with status dots
|
||||||
|
claudemesh member list --online # only online
|
||||||
|
claudemesh member list --mesh deploys --json
|
||||||
|
```
|
||||||
|
|
||||||
|
Status glyphs: `●` emerald = idle, `●` clay = working, `●` red = dnd, `○` dim = offline. `bot` tag appears on non-human members.
|
||||||
|
|
||||||
|
### `notification` — recent @-mentions (v1.7.0)
|
||||||
|
|
||||||
|
Server-side write-time fan-out from `mesh.notification` — one row per recipient per matching `@-mention`. Works for both v1 plaintext and v2 ciphertext (clients send the mention list explicitly on v2).
|
||||||
|
|
||||||
|
```bash
|
||||||
|
claudemesh notification list # last 24h, all mentions of you
|
||||||
|
claudemesh notification list --since 2026-05-01T00:00Z # incremental for polling
|
||||||
|
claudemesh notification list --json # parseable
|
||||||
|
```
|
||||||
|
|
||||||
|
### Per-topic encryption (v0.3.0 / CLI 1.8.0)
|
||||||
|
|
||||||
|
Topics created on or after CLI 1.8.0 generate a 32-byte XSalsa20-Poly1305 symmetric key sealed for each member via `crypto_box`. The broker holds ciphertext only. `topic post` encrypts; `topic tail` decrypts. The `🔒 v2` glyph in tail output marks ciphertext rounds. v1 plaintext topics keep working unchanged.
|
||||||
|
|
||||||
|
When a new member joins an encrypted topic, they get a 404 from `GET /v1/topics/:name/key` until any holder re-seals for them. `topic tail` runs a 30s background loop that does the re-seal automatically while the tail is open. Otherwise the joiner waits for someone with the key to log in.
|
||||||
|
|
||||||
### `peer` — read connected peers + admin (kick / ban / verify)
|
### `peer` — read connected peers + admin (kick / ban / verify)
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
|||||||
Reference in New Issue
Block a user