claudemesh-cli 1.2.1 → 1.4.0

package/skills/claudemesh/SKILL.md

@@ -27,13 +27,22 @@ If the parent Claude session was launched via `claudemesh launch`, an MCP push-p
 
 ## Resources and verbs
 
-### `peer` — read connected peers
+**Convention:** every operation is `claudemesh <resource> <verb>`. Legacy short forms (`send`, `peers`, `kick`, `remember`, ...) are aliases that keep working forever; prefer the resource form for new code.
+
+### `peer` — read connected peers + admin (kick / ban / verify)
 
 ```bash
-claudemesh peers                          # human-readable
-claudemesh peers --json                   # full record
-claudemesh peers --json name,status       # field projection
-claudemesh peers --mesh openclaw --json   # specific mesh
+claudemesh peer list                              # human-readable (alias: peers)
+claudemesh peer list --json                       # full record
+claudemesh peer list --json name,status           # field projection
+claudemesh peer list --mesh openclaw --json       # specific mesh
+
+claudemesh peer kick <peer>                       # end session, manual rejoin
+claudemesh peer disconnect <peer>                 # soft, peer auto-reconnects
+claudemesh peer ban <peer>                        # kick + revoke membership
+claudemesh peer unban <peer>
+claudemesh peer bans                              # list banned members
+claudemesh peer verify [peer]                     # 6×5-digit safety numbers
 ```
 
 JSON shape (per peer):
@@ -55,22 +64,22 @@ JSON shape (per peer):
 ### `message` — send and inspect messages
 
 ```bash
-# send
-claudemesh send <peer-name|@group|*|pubkey> "message text"
-claudemesh send Mou "hi"                          # by display name
-claudemesh send "@reviewers" "ready for review"   # to a group
-claudemesh send "*" "broadcast to all"            # to everyone
-claudemesh send <peer> "msg" --priority now       # bypass busy gates
-claudemesh send <peer> "msg" --priority next      # default — waits for idle
-claudemesh send <peer> "msg" --priority low       # pull-only
-
-# inbox (drain pending)
-claudemesh inbox                          # human-readable
-claudemesh inbox --json                   # JSON
-
-# delivery status of a message you sent
-claudemesh msg-status <message-id>
-claudemesh msg-status <message-id> --json
+# send (alias: claudemesh send <to> <msg>)
+claudemesh message send <peer-name|@group|*|pubkey> "message text"
+claudemesh message send Mou "hi"                       # by display name
+claudemesh message send "@reviewers" "ready for review"
+claudemesh message send "*" "broadcast"
+claudemesh message send <p> "..." --priority now       # bypass busy gates
+claudemesh message send <p> "..." --priority next      # default
+claudemesh message send <p> "..." --priority low       # pull-only
+
+# inbox (alias: claudemesh inbox)
+claudemesh message inbox
+claudemesh message inbox --json
+
+# delivery status (alias: claudemesh msg-status <id>)
+claudemesh message status <message-id>
+claudemesh message status <message-id> --json
 ```
 
 `send` JSON output: `{"ok": true, "messageId": "...", "target": "..."}`. Errors: `{"ok": false, "error": "..."}`.
@@ -90,46 +99,164 @@ State is broadcast to all peers when changed. Use it for shared scratch space: s
 ### `memory` — recall-able knowledge per mesh
 
 ```bash
-claudemesh remember "fact text" --tags tag1,tag2
-claudemesh recall "search query"
-claudemesh recall "search query" --json
-claudemesh forget <memory-id>
+claudemesh memory remember "fact text" --tags tag1,tag2     # alias: remember
+claudemesh memory recall "search query"                     # alias: recall
+claudemesh memory recall "search query" --json
+claudemesh memory forget <memory-id>                        # alias: forget
 ```
 
 Memories are searchable across the mesh. Use for shared documentation, decisions, lessons learned.
 
-### `task` — claim-and-complete work units
+### `task` — typed work-units claim/complete
 
 ```bash
+claudemesh task create "<title>" --assignee <peer> --priority <p> --tags a,b
+claudemesh task list [--status open|claimed|done] [--assignee <peer>] [--json]
 claudemesh task claim <task-id>
 claudemesh task complete <task-id> [result text]
 ```
 
-(Task creation + listing currently goes through the mesh-level UI / API; CLI verbs for create/list arrive in 1.3.)
+Tasks are exact-once: claiming is atomic at broker. Use for work coordination across peers.
 
 ### `schedule` — time-based delivery
 
 ```bash
-# one-shot or recurring reminder to yourself or a peer
-claudemesh remind "your message" --in 30m            # fires in 30 min
-claudemesh remind "your message" --at 15:00          # next 15:00
-claudemesh remind "ping me" --cron "0 9 * * *"       # 9am daily
-claudemesh remind "to peer" --to <peer-name>         # send to someone else
-claudemesh remind list --json
-claudemesh remind cancel <reminder-id>
+# one-shot or recurring (alias: claudemesh remind ...)
+claudemesh schedule msg "ping" --in 30m              # fires in 30 min
+claudemesh schedule msg "ping" --at 15:00            # next 15:00
+claudemesh schedule msg "ping" --cron "0 9 * * *"    # 9am daily
+claudemesh schedule msg "to peer" --to <peer-name>
+claudemesh schedule list --json
+claudemesh schedule cancel <reminder-id>
+
+# webhook + tool schedules arrive in a later release (broker work pending).
+```
+
+### `profile / group` — peer presence
+
+```bash
+claudemesh profile                              # view/edit your profile
+claudemesh profile summary "what you're working on"   # broadcast (alias: summary)
+claudemesh profile status set idle|working|dnd        # alias: status set
+claudemesh profile visible true|false                 # alias: visible
+claudemesh group join @reviewers --role lead
+claudemesh group leave @reviewers
+```
+
+### `vector` — embedding store + similarity search
+
+```bash
+claudemesh vector store <collection> "<text>" [--metadata '<json>']
+claudemesh vector search <collection> "<query>" [--limit N] [--json]
+claudemesh vector delete <collection> <id>
+claudemesh vector collections          # list collection names
+```
+
+Search returns `[{id, text, score, metadata}]` ranked by cosine similarity.
+
+### `graph` — Cypher queries against per-mesh graph
+
+```bash
+claudemesh graph query "MATCH (n) RETURN n LIMIT 10"   # read
+claudemesh graph execute "CREATE (n:Foo {x: 1})"      # write
+```
+
+Returns rows as `[{...}, ...]`. Queries that return no rows render "(no rows)".
+
+### `context` — share work-context summaries between peers
+
+```bash
+claudemesh context share "summary text" --files a.ts,b.ts --findings "x,y" --tags spec,review
+claudemesh context get "search query"
+claudemesh context list
 ```
 
-### `profile / status / visibility / groups` — peer presence
+Use to broadcast "what I just did and what I learned" so peers don't duplicate effort.
+
+### `stream` — pub/sub event bus
 
 ```bash
-claudemesh status set idle | working | dnd     # explicit status
-claudemesh summary "what you're working on"    # 1-2 sentence summary, broadcast
-claudemesh visible true | false                # toggle visibility
-claudemesh group join @reviewers --role lead   # join a group
-claudemesh group leave @reviewers              # leave a group
-claudemesh profile                             # view/edit your profile
+claudemesh stream create <name>
+claudemesh stream publish <name> '<json-or-text>'
+claudemesh stream list
 ```
 
+For event broadcasting (build-events, deploy-notifications, sensor data). Subscribers receive via push.
+
+### `sql` — typed SQL against per-mesh tables
+
+```bash
+claudemesh sql query "SELECT * FROM <table>"     # SELECT only
+claudemesh sql execute "INSERT INTO ..."         # writes
+claudemesh sql schema                            # list tables + columns
+```
+
+Returns `{columns, rows, rowCount}` for queries. Each mesh has its own SQL namespace.
+
+### `skill` — discover + manage mesh-published Claude skills
+
+```bash
+claudemesh skill list [search-query]
+claudemesh skill get <skill-name>
+claudemesh skill remove <skill-name>
+```
+
+Published skills appear as `/claudemesh:<name>` slash commands across all connected sessions.
+
+### `vault` — encrypted per-mesh secrets
+
+```bash
+claudemesh vault list                # list keys (values stay encrypted on disk)
+claudemesh vault delete <key>
+# claudemesh vault set/get currently goes through MCP — needs E2E crypto round-trip
+```
+
+### `watch` — URL change watchers
+
+```bash
+claudemesh watch list                # list active watches
+claudemesh watch remove <watch-id>
+# Watch creation currently via MCP `mesh_watch` — config-heavy
+```
+
+### `webhook` — outbound HTTP triggers
+
+```bash
+claudemesh webhook list              # list configured webhooks
+claudemesh webhook delete <name>
+# Webhook creation currently via MCP `create_webhook`
+```
+
+### `file` — shared mesh files
+
+```bash
+claudemesh file list [search-query]  # list files
+claudemesh file status <file-id>     # who has accessed
+claudemesh file delete <file-id>
+# Upload + retrieval currently via MCP `share_file` / `get_file` (binary streams)
+```
+
+### `mesh-mcp` — call MCP servers other peers deployed to the mesh
+
+```bash
+claudemesh mesh-mcp list             # which servers are deployed
+claudemesh mesh-mcp call <server> <tool> '<json-args>'
+claudemesh mesh-mcp catalog          # full catalog with schemas
+```
+
+Mesh-deployed MCPs let peer X call a tool that peer Y maintains, without local install.
+
+### `clock` — mesh logical clock
+
+```bash
+claudemesh clock                     # current state
+claudemesh clock set <speed>         # speed: 0=paused, 1=realtime, 60=60× faster
+claudemesh clock pause
+claudemesh clock resume
+```
+
+Used for simulations / tests that need a controlled time axis shared across peers.
+
 ### `mesh` — mesh-level introspection
 
 ```bash