claudemesh-cli 0.6.8 → 0.6.9

package/dist/index.js

@@ -47376,13 +47376,14 @@ var TOOLS = [
   },
   {
     name: "schedule_reminder",
-    description: "Schedule a message for future delivery. Without `to`, it fires back to yourself (a self-reminder). With `to`, it delivers to a peer, @group, or * broadcast. The broker holds it and delivers when the time arrives. Receivers see `subtype: reminder` in the push envelope.",
+    description: "Schedule a one-shot or recurring message. Without `to`, it fires back to yourself (a self-reminder). With `to`, it delivers to a peer, @group, or * broadcast. For one-shot, provide `deliver_at` or `in_seconds`. For recurring, provide `cron` (standard 5-field expression). The broker persists schedules to the database — they survive restarts. Receivers see `subtype: reminder` in the push envelope.",
     inputSchema: {
       type: "object",
       properties: {
         message: { type: "string", description: "Message or reminder text" },
-        deliver_at: { type: "number", description: "Unix timestamp (ms) when to deliver" },
-        in_seconds: { type: "number", description: "Alternative to deliver_at: fire after N seconds" },
+        deliver_at: { type: "number", description: "Unix timestamp (ms) when to deliver (one-shot)" },
+        in_seconds: { type: "number", description: "Alternative to deliver_at: fire after N seconds (one-shot)" },
+        cron: { type: "string", description: "Cron expression for recurring reminders (e.g. '0 */2 * * *' for every 2 hours, '30 9 * * 1-5' for 9:30 weekdays)" },
         to: {
           type: "string",
           description: "Recipient: display name, pubkey hex, @group, or * (omit for self-reminder)"
@@ -47565,6 +47566,9 @@ class BrokerClient {
             sessionId: `${process.pid}-${Date.now()}`,
             pid: process.pid,
             cwd: process.cwd(),
+            peerType: "ai",
+            channel: "claude-code",
+            model: process.env.CLAUDE_MODEL || undefined,
             timestamp,
             signature
           }));
@@ -47773,7 +47777,7 @@ class BrokerClient {
       return;
     this.ws.send(JSON.stringify({ type: "forget", memoryId }));
   }
-  async scheduleMessage(to, message, deliverAt, isReminder = false) {
+  async scheduleMessage(to, message, deliverAt, isReminder = false, cron) {
     if (!this.ws || this.ws.readyState !== this.ws.OPEN)
       return null;
     return new Promise((resolve) => {
@@ -47788,6 +47792,7 @@ class BrokerClient {
         message,
         deliverAt,
         ...isReminder ? { subtype: "reminder" } : {},
+        ...cron ? { cron, recurring: true } : {},
         _reqId: reqId
       }));
     });
@@ -48234,7 +48239,9 @@ class BrokerClient {
           receivedAt: new Date().toISOString(),
           plaintext,
           kind,
-          ...msg.subtype ? { subtype: msg.subtype } : {}
+          ...msg.subtype ? { subtype: msg.subtype } : {},
+          ...msg.event ? { event: String(msg.event) } : {},
+          ...msg.eventData ? { eventData: msg.eventData } : {}
         };
         this.pushBuffer.push(push);
         if (this.pushBuffer.length > 500)
@@ -48402,7 +48409,8 @@ class BrokerClient {
     if (msg.type === "scheduled_ack") {
       this.resolveFromMap(this.scheduledAckResolvers, msgReqId, {
         scheduledId: String(msg.scheduledId ?? ""),
-        deliverAt: Number(msg.deliverAt ?? 0)
+        deliverAt: Number(msg.deliverAt ?? 0),
+        ...msg.cron ? { cron: String(msg.cron) } : {}
       });
       return;
     }
@@ -48805,7 +48813,16 @@ No peers connected.`);
             const peerLines = peers.map((p) => {
               const summary = p.summary ? ` — "${p.summary}"` : "";
               const groupsStr = p.groups?.length ? ` [${p.groups.map((g) => `@${g.name}${g.role ? ":" + g.role : ""}`).join(", ")}]` : "";
-              return `- **${p.displayName}** [${p.status}]${groupsStr} (${p.pubkey.slice(0, 12)}…)${summary}`;
+              const meta2 = [];
+              if (p.peerType)
+                meta2.push(`type:${p.peerType}`);
+              if (p.channel)
+                meta2.push(`channel:${p.channel}`);
+              if (p.model)
+                meta2.push(`model:${p.model}`);
+              const metaStr = meta2.length ? ` {${meta2.join(", ")}}` : "";
+              const cwdStr = p.cwd ? ` cwd:${p.cwd}` : "";
+              return `- **${p.displayName}** [${p.status}]${groupsStr}${metaStr} (${p.pubkey.slice(0, 12)}…)${cwdStr}${summary}`;
             });
             sections.push(`${header}
 ${peerLines.join(`
@@ -48958,13 +48975,16 @@ ${lines.join(`
         const sArgs = args ?? {};
         if (!sArgs.message)
           return text("schedule_reminder: `message` required", true);
+        const isCron = !!sArgs.cron;
         let deliverAt;
-        if (sArgs.deliver_at) {
+        if (isCron) {
+          deliverAt = 0;
+        } else if (sArgs.deliver_at) {
           deliverAt = Number(sArgs.deliver_at);
         } else if (sArgs.in_seconds) {
           deliverAt = Date.now() + Number(sArgs.in_seconds) * 1000;
         } else {
-          return text("schedule_reminder: provide `deliver_at` (ms timestamp) or `in_seconds`", true);
+          return text("schedule_reminder: provide `deliver_at` (ms timestamp), `in_seconds`, or `cron` expression", true);
         }
         const isSelf = !sArgs.to;
         let targetSpec;
@@ -48984,9 +49004,13 @@ ${lines.join(`
             targetSpec = to;
           }
         }
-        const result = await client.scheduleMessage(targetSpec, sArgs.message, deliverAt, true);
+        const result = await client.scheduleMessage(targetSpec, sArgs.message, deliverAt, true, sArgs.cron);
         if (!result)
           return text("schedule_reminder: broker did not acknowledge — check connection", true);
+        if (isCron) {
+          const nextFire = new Date(result.deliverAt).toISOString();
+          return text(isSelf ? `Recurring self-reminder scheduled (${result.scheduledId.slice(0, 8)}): "${sArgs.message.slice(0, 60)}" — cron: ${sArgs.cron}, next fire: ${nextFire}` : `Recurring reminder to "${sArgs.to}" scheduled (${result.scheduledId.slice(0, 8)}) — cron: ${sArgs.cron}, next fire: ${nextFire}`);
+        }
         const when = new Date(result.deliverAt).toISOString();
         return text(isSelf ? `Self-reminder scheduled (${result.scheduledId.slice(0, 8)}): "${sArgs.message.slice(0, 60)}" at ${when}` : `Reminder to "${sArgs.to}" scheduled (${result.scheduledId.slice(0, 8)}) for ${when}`);
       }
@@ -49502,6 +49526,39 @@ ${rows.join(`
     client2.onPush(async (msg) => {
       if (messageMode === "off")
         return;
+      if (msg.subtype === "system" && msg.event) {
+        const eventName = msg.event;
+        const data = msg.eventData ?? {};
+        let content2;
+        if (eventName === "peer_joined") {
+          content2 = `[system] Peer "${data.name ?? "unknown"}" joined the mesh`;
+        } else if (eventName === "peer_left") {
+          content2 = `[system] Peer "${data.name ?? "unknown"}" left the mesh`;
+        } else {
+          content2 = `[system] ${eventName}: ${JSON.stringify(data)}`;
+        }
+        try {
+          await server.notification({
+            method: "notifications/claude/channel",
+            params: {
+              content: content2,
+              meta: {
+                kind: "system",
+                event: eventName,
+                mesh_slug: client2.meshSlug,
+                mesh_id: client2.meshId,
+                ...Object.keys(data).length > 0 ? { eventData: data } : {}
+              }
+            }
+          });
+          process.stderr.write(`[claudemesh] system: ${content2}
+`);
+        } catch (pushErr) {
+          process.stderr.write(`[claudemesh] system push FAILED: ${pushErr}
+`);
+        }
+        return;
+      }
       const fromPubkey = msg.senderPubkey || "";
       const fromName = fromPubkey ? await resolvePeerName(client2, fromPubkey) : "unknown";
       if (messageMode === "inbox") {
@@ -49725,47 +49782,51 @@ function writeClaudeSettings(obj) {
 `, "utf-8");
 }
 var CLAUDEMESH_TOOLS = [
-  "mcp__claudemesh__send_message",
-  "mcp__claudemesh__list_peers",
+  "mcp__claudemesh__cancel_scheduled",
   "mcp__claudemesh__check_messages",
-  "mcp__claudemesh__set_summary",
-  "mcp__claudemesh__set_status",
-  "mcp__claudemesh__join_group",
-  "mcp__claudemesh__leave_group",
-  "mcp__claudemesh__get_state",
-  "mcp__claudemesh__set_state",
-  "mcp__claudemesh__list_state",
-  "mcp__claudemesh__remember",
-  "mcp__claudemesh__recall",
+  "mcp__claudemesh__claim_task",
+  "mcp__claudemesh__complete_task",
+  "mcp__claudemesh__create_stream",
+  "mcp__claudemesh__create_task",
+  "mcp__claudemesh__delete_file",
+  "mcp__claudemesh__file_status",
   "mcp__claudemesh__forget",
-  "mcp__claudemesh__share_file",
+  "mcp__claudemesh__get_context",
   "mcp__claudemesh__get_file",
-  "mcp__claudemesh__list_files",
-  "mcp__claudemesh__file_status",
-  "mcp__claudemesh__delete_file",
-  "mcp__claudemesh__vector_store",
-  "mcp__claudemesh__vector_search",
-  "mcp__claudemesh__vector_delete",
-  "mcp__claudemesh__list_collections",
-  "mcp__claudemesh__graph_query",
+  "mcp__claudemesh__get_state",
+  "mcp__claudemesh__grant_file_access",
   "mcp__claudemesh__graph_execute",
-  "mcp__claudemesh__mesh_info",
-  "mcp__claudemesh__ping_mesh",
-  "mcp__claudemesh__message_status",
-  "mcp__claudemesh__share_context",
-  "mcp__claudemesh__get_context",
+  "mcp__claudemesh__graph_query",
+  "mcp__claudemesh__join_group",
+  "mcp__claudemesh__leave_group",
+  "mcp__claudemesh__list_collections",
   "mcp__claudemesh__list_contexts",
-  "mcp__claudemesh__create_task",
-  "mcp__claudemesh__claim_task",
-  "mcp__claudemesh__complete_task",
-  "mcp__claudemesh__list_tasks",
-  "mcp__claudemesh__create_stream",
-  "mcp__claudemesh__publish",
-  "mcp__claudemesh__subscribe",
+  "mcp__claudemesh__list_files",
+  "mcp__claudemesh__list_peers",
+  "mcp__claudemesh__list_scheduled",
+  "mcp__claudemesh__list_state",
   "mcp__claudemesh__list_streams",
+  "mcp__claudemesh__list_tasks",
   "mcp__claudemesh__mesh_execute",
+  "mcp__claudemesh__mesh_info",
   "mcp__claudemesh__mesh_query",
-  "mcp__claudemesh__mesh_schema"
+  "mcp__claudemesh__mesh_schema",
+  "mcp__claudemesh__message_status",
+  "mcp__claudemesh__ping_mesh",
+  "mcp__claudemesh__publish",
+  "mcp__claudemesh__recall",
+  "mcp__claudemesh__remember",
+  "mcp__claudemesh__schedule_reminder",
+  "mcp__claudemesh__send_message",
+  "mcp__claudemesh__set_state",
+  "mcp__claudemesh__set_status",
+  "mcp__claudemesh__set_summary",
+  "mcp__claudemesh__share_context",
+  "mcp__claudemesh__share_file",
+  "mcp__claudemesh__subscribe",
+  "mcp__claudemesh__vector_delete",
+  "mcp__claudemesh__vector_search",
+  "mcp__claudemesh__vector_store"
 ];
 function installAllowedTools() {
   const settings = readClaudeSettings();
@@ -50559,7 +50620,7 @@ init_config();
 // package.json
 var package_default = {
   name: "claudemesh-cli",
-  version: "0.6.8",
+  version: "0.6.9",
   description: "Claude Code MCP client for claudemesh — peer mesh messaging between Claude sessions.",
   keywords: [
     "claude-code",
@@ -51025,8 +51086,19 @@ async function runPeers(flags) {
       const groups = p.groups.length ? " [" + p.groups.map((g) => `@${g.name}${g.role ? `:${g.role}` : ""}`).join(", ") + "]" : "";
       const statusIcon = p.status === "working" ? yellow("●") : green("●");
       const name = bold2(p.displayName);
+      const meta2 = [];
+      if (p.peerType)
+        meta2.push(p.peerType);
+      if (p.channel)
+        meta2.push(p.channel);
+      if (p.model)
+        meta2.push(p.model);
+      const metaStr = meta2.length ? dim(` (${meta2.join(", ")})`) : "";
+      const cwdStr = p.cwd ? dim(`  cwd: ${p.cwd}`) : "";
       const summary = p.summary ? dim(`  ${p.summary}`) : "";
-      console.log(`  ${statusIcon} ${name}${groups}${summary}`);
+      console.log(`  ${statusIcon} ${name}${groups}${metaStr}${summary}`);
+      if (cwdStr)
+        console.log(`    ${cwdStr}`);
     }
     console.log("");
   });
@@ -51313,13 +51385,15 @@ async function runRemind(flags, positional) {
   if (!message) {
     console.error("Usage: claudemesh remind <message> --in <duration>");
     console.error("       claudemesh remind <message> --at <time>");
+    console.error('       claudemesh remind <message> --cron "0 */2 * * *"');
     console.error("       claudemesh remind list");
     console.error("       claudemesh remind cancel <id>");
     process.exit(1);
   }
-  const deliverAt = parseDeliverAt(flags);
-  if (deliverAt === null) {
-    console.error('Specify when: --in <duration> (e.g. "2h", "30m") or --at <time> (e.g. "15:00")');
+  const isCron = !!flags.cron;
+  const deliverAt = isCron ? 0 : parseDeliverAt(flags);
+  if (!isCron && deliverAt === null) {
+    console.error('Specify when: --in <duration> (e.g. "2h", "30m"), --at <time> (e.g. "15:00"), or --cron <expression>');
     process.exit(1);
   }
   await withMesh({ meshSlug: flags.mesh ?? null }, async (client2) => {
@@ -51339,7 +51413,7 @@ async function runRemind(flags, positional) {
     } else {
       targetSpec = client2.getSessionPubkey() ?? "*";
     }
-    const result = await client2.scheduleMessage(targetSpec, message, deliverAt);
+    const result = await client2.scheduleMessage(targetSpec, message, deliverAt ?? 0, false, flags.cron);
     if (!result) {
       console.error("✗ Broker did not acknowledge — check connection");
       process.exit(1);
@@ -51348,34 +51422,170 @@ async function runRemind(flags, positional) {
       console.log(JSON.stringify(result));
       return;
     }
-    const when = new Date(result.deliverAt).toLocaleString();
     const toLabel = !flags.to || flags.to === "self" ? "yourself" : flags.to;
-    console.log(`✓ Reminder set (${result.scheduledId.slice(0, 8)}): "${message}" → ${toLabel} at ${when}`);
+    if (isCron) {
+      const nextFire = new Date(result.deliverAt).toLocaleString();
+      console.log(`✓ Recurring reminder set (${result.scheduledId.slice(0, 8)}): "${message}" → ${toLabel} — cron: ${flags.cron}, next fire: ${nextFire}`);
+    } else {
+      const when = new Date(result.deliverAt).toLocaleString();
+      console.log(`✓ Reminder set (${result.scheduledId.slice(0, 8)}): "${message}" → ${toLabel} at ${when}`);
+    }
   });
 }
+// src/templates/dev-team.json
+var dev_team_default = {
+  name: "dev-team",
+  description: "Software development team with frontend, backend, and devops groups",
+  groups: [
+    { name: "frontend", roles: ["lead", "member"] },
+    { name: "backend", roles: ["lead", "member"] },
+    { name: "devops", roles: ["lead", "member"] },
+    { name: "qa", roles: ["lead", "member"] }
+  ],
+  stateKeys: {
+    sprint: "current",
+    "deploy-frozen": "false",
+    "pr-queue": "[]"
+  },
+  suggestedRoles: ["lead", "member", "reviewer"],
+  systemPromptHint: "You are part of a dev team. Coordinate with @frontend, @backend, @devops groups. Check state keys for sprint status and deploy freezes before making changes."
+};
+// src/templates/research.json
+var research_default = {
+  name: "research",
+  description: "Research and analysis team focused on deep investigation and knowledge sharing",
+  groups: [
+    { name: "analysis", roles: ["lead", "analyst"] },
+    { name: "writing", roles: ["lead", "writer", "reviewer"] },
+    { name: "data", roles: ["engineer", "analyst"] }
+  ],
+  stateKeys: {
+    "research-topic": "",
+    phase: "exploration",
+    "findings-count": "0"
+  },
+  suggestedRoles: ["lead", "analyst", "writer", "reviewer"],
+  systemPromptHint: "You are part of a research team. Share findings via remember(), use recall() before starting new analysis. Coordinate phases through state keys."
+};
+// src/templates/ops-incident.json
+var ops_incident_default = {
+  name: "ops-incident",
+  description: "Incident response team with oncall, comms, and engineering groups",
+  groups: [
+    { name: "oncall", roles: ["primary", "secondary"] },
+    { name: "comms", roles: ["lead", "scribe"] },
+    { name: "engineering", roles: ["lead", "responder"] }
+  ],
+  stateKeys: {
+    "incident-status": "investigating",
+    severity: "unknown",
+    commander: "",
+    timeline: "[]"
+  },
+  suggestedRoles: ["commander", "primary-oncall", "scribe", "responder"],
+  systemPromptHint: "INCIDENT MODE. Priority: now for all messages. Update incident-status state. Commander coordinates. Scribe maintains timeline. Engineering fixes."
+};
+// src/templates/simulation.json
+var simulation_default = {
+  name: "simulation",
+  description: "Load testing simulation with configurable time multiplier and user personas",
+  groups: [
+    { name: "personas", roles: ["admin", "user", "customer"] },
+    { name: "observers", roles: ["monitor", "analyst"] },
+    { name: "control", roles: ["orchestrator"] }
+  ],
+  stateKeys: {
+    "clock-speed": "x1",
+    "sim-status": "paused",
+    "tick-count": "0",
+    scenario: ""
+  },
+  suggestedRoles: ["orchestrator", "persona", "monitor"],
+  systemPromptHint: "SIMULATION MODE. Follow the clock-speed state for time multiplier. Act according to your persona role and the simulated time. Report actions to @observers."
+};
+// src/templates/personal.json
+var personal_default = {
+  name: "personal",
+  description: "Private mesh for a single user — all sessions auto-join",
+  groups: [],
+  stateKeys: {
+    focus: "",
+    todos: "[]"
+  },
+  suggestedRoles: [],
+  systemPromptHint: "Personal workspace. All your Claude Code sessions share this mesh. Use state keys to track focus and todos across sessions."
+};
+
+// src/templates/index.ts
+var TEMPLATES = {
+  "dev-team": dev_team_default,
+  research: research_default,
+  "ops-incident": ops_incident_default,
+  simulation: simulation_default,
+  personal: personal_default
+};
+function listTemplates() {
+  return Object.values(TEMPLATES);
+}
+function getTemplate(name) {
+  return TEMPLATES[name];
+}
+
+// src/commands/create.ts
+function runCreate(args) {
+  if (args["list-templates"]) {
+    console.log(`Available mesh templates:
+`);
+    for (const t of listTemplates()) {
+      console.log(`  ${t.name}`);
+      console.log(`    ${t.description}`);
+      console.log(`    Groups: ${t.groups.map((g) => g.name).join(", ") || "(none)"}`);
+      console.log(`    State keys: ${Object.keys(t.stateKeys).join(", ") || "(none)"}`);
+      console.log();
+    }
+    return;
+  }
+  const templateName = args.template;
+  if (templateName) {
+    const template = getTemplate(templateName);
+    if (!template) {
+      console.error(`Unknown template "${templateName}". Use --list-templates to see available options.`);
+      process.exit(1);
+    }
+    console.log(`Template "${template.name}" loaded:`);
+    console.log(`  Groups: ${template.groups.map((g) => `@${g.name}`).join(", ")}`);
+    console.log(`  State keys: ${Object.keys(template.stateKeys).join(", ")}`);
+    console.log(`  Hint: ${template.systemPromptHint.slice(0, 80)}...`);
+    console.log();
+    console.log("Template applied. Use `claudemesh launch` with --groups to join the predefined groups.");
+    return;
+  }
+  console.log("Usage: claudemesh create --template <name>");
+  console.log("       claudemesh create --list-templates");
+}
 
 // src/index.ts
 var launch = defineCommand({
   meta: {
     name: "launch",
-    description: "Launch Claude Code connected to a mesh with real-time peer messaging"
+    description: "Spawn a Claude Code session with mesh connectivity and MCP tools"
   },
   args: {
     name: {
       type: "string",
-      description: "Display name for this session"
+      description: "Display name visible to other peers"
     },
     role: {
       type: "string",
-      description: "Role tag (dev, lead, analyst — free-form)"
+      description: "Free-form role tag: `dev`, `lead`, `analyst`, etc"
     },
     groups: {
       type: "string",
-      description: 'Groups to join: "group:role,group2" — colon sets role. Hierarchy via slash: "eng/frontend:lead"'
+      description: 'Groups to join as `group:role,...` — e.g. `"eng/frontend:lead,qa:member"`'
     },
     mesh: {
       type: "string",
-      description: "Select mesh by slug (interactive picker if omitted and >1 joined)"
+      description: "Mesh slug (interactive picker if omitted and >1 joined)"
     },
     join: {
       type: "string",
@@ -51383,21 +51593,21 @@ var launch = defineCommand({
     },
     "message-mode": {
       type: "string",
-      description: "push (default) | inbox | off — controls how peer messages are delivered"
+      description: '`"push"` (default) | `"inbox"` | `"off"` — how peer messages arrive'
     },
     "system-prompt": {
       type: "string",
-      description: "Set Claude's system prompt for this session"
+      description: "Custom system prompt for this Claude session"
     },
     yes: {
       type: "boolean",
       alias: "y",
-      description: "Skip permission confirmation",
+      description: "Skip the --dangerously-skip-permissions confirmation",
       default: false
     },
     quiet: {
       type: "boolean",
-      description: "Skip banner and all interactive prompts",
+      description: "Suppress banner and interactive prompts",
       default: false
     }
   },
@@ -51408,7 +51618,7 @@ var launch = defineCommand({
 var install = defineCommand({
   meta: {
     name: "install",
-    description: "Register MCP server + status hooks with Claude Code"
+    description: "Register MCP server and status hooks with Claude Code"
   },
   args: {
     "no-hooks": {
@@ -51424,12 +51634,12 @@ var install = defineCommand({
 var join7 = defineCommand({
   meta: {
     name: "join",
-    description: "Join a mesh via invite URL"
+    description: "Join a mesh via invite URL or token"
   },
   args: {
     url: {
       type: "positional",
-      description: "Invite URL (https://claudemesh.com/join/...)",
+      description: "Invite URL (`https://claudemesh.com/join/...`) or token",
       required: true
     }
   },
@@ -51440,12 +51650,12 @@ var join7 = defineCommand({
 var leave = defineCommand({
   meta: {
     name: "leave",
-    description: "Leave a joined mesh"
+    description: "Leave a joined mesh and remove its local keypair"
   },
   args: {
     slug: {
       type: "positional",
-      description: "Mesh slug to leave",
+      description: "Mesh slug to leave (see `claudemesh list`)",
       required: true
     }
   },
@@ -51461,23 +51671,33 @@ var main = defineCommand({
   },
   subCommands: {
     launch,
+    create: defineCommand({
+      meta: { name: "create", description: "Create a new mesh from a template" },
+      args: {
+        template: { type: "string", description: "Template name: `dev-team`, `research`, `ops-incident`, `simulation`, `personal`" },
+        "list-templates": { type: "boolean", description: "List available templates and exit", default: false }
+      },
+      run({ args }) {
+        runCreate(args);
+      }
+    }),
     install,
     uninstall: defineCommand({
-      meta: { name: "uninstall", description: "Remove MCP server and hooks" },
+      meta: { name: "uninstall", description: "Remove MCP server and hooks from Claude Code config" },
       run() {
         runUninstall();
       }
     }),
     join: join7,
     list: defineCommand({
-      meta: { name: "list", description: "Show joined meshes and identities" },
+      meta: { name: "list", description: "Show joined meshes, slugs, and local identities" },
       run() {
         runList();
       }
     }),
     leave,
     peers: defineCommand({
-      meta: { name: "peers", description: "List connected peers in the mesh" },
+      meta: { name: "peers", description: "List online peers with status, summary, and groups" },
       args: {
         mesh: { type: "string", description: "Mesh slug (auto-selected if only one joined)" },
         json: { type: "boolean", description: "Output as JSON", default: false }
@@ -51487,34 +51707,34 @@ var main = defineCommand({
       }
     }),
     send: defineCommand({
-      meta: { name: "send", description: "Send a message to a peer, group, or broadcast" },
+      meta: { name: "send", description: "Send a message to a peer, group, or all peers" },
       args: {
-        to: { type: "positional", description: "Recipient: display name, @group, pubkey, or *", required: true },
+        to: { type: "positional", description: "Recipient: display name, `@group`, `*` (broadcast), or pubkey hex", required: true },
         message: { type: "positional", description: "Message text", required: true },
         mesh: { type: "string", description: "Mesh slug (auto-selected if only one joined)" },
-        priority: { type: "string", description: "now | next (default) | low" }
+        priority: { type: "string", description: '`"now"` | `"next"` (default) | `"low"`' }
       },
       async run({ args }) {
         await runSend(args, args.to, args.message);
       }
     }),
     inbox: defineCommand({
-      meta: { name: "inbox", description: "Read pending peer messages" },
+      meta: { name: "inbox", description: "Drain pending inbound messages" },
       args: {
         mesh: { type: "string", description: "Mesh slug (auto-selected if only one joined)" },
         json: { type: "boolean", description: "Output as JSON", default: false },
-        wait: { type: "string", description: "Seconds to wait for broker delivery (default: 1)" }
+        wait: { type: "string", description: "Seconds to wait for broker delivery (default: `1`)" }
       },
       async run({ args }) {
         await runInbox({ ...args, wait: args.wait ? parseInt(args.wait, 10) : undefined });
       }
     }),
     state: defineCommand({
-      meta: { name: "state", description: "Read or write shared mesh state" },
+      meta: { name: "state", description: "Get, set, or list shared key-value state in the mesh" },
       args: {
-        action: { type: "positional", description: "get | set | list", required: true },
-        key: { type: "positional", description: "State key (required for get/set)" },
-        value: { type: "positional", description: "Value to set (required for set)" },
+        action: { type: "positional", description: "`get <key>` | `set <key> <value>` | `list`", required: true },
+        key: { type: "positional", description: "State key (required for `get` and `set`)" },
+        value: { type: "positional", description: "Value to store (required for `set`)" },
         mesh: { type: "string", description: "Mesh slug (auto-selected if only one joined)" },
         json: { type: "boolean", description: "Output as JSON", default: false }
       },
@@ -51550,11 +51770,11 @@ var main = defineCommand({
       }
     }),
     remember: defineCommand({
-      meta: { name: "remember", description: "Store a memory in the mesh (accessible to all peers)" },
+      meta: { name: "remember", description: "Store a persistent memory visible to all peers" },
       args: {
-        content: { type: "positional", description: "Text to remember", required: true },
+        content: { type: "positional", description: "Text to store", required: true },
         mesh: { type: "string", description: "Mesh slug (auto-selected if only one joined)" },
-        tags: { type: "string", description: "Comma-separated tags (e.g. task,context)" },
+        tags: { type: "string", description: "Comma-separated tags, e.g. `task,context`" },
         json: { type: "boolean", description: "Output as JSON", default: false }
       },
       async run({ args }) {
@@ -51562,9 +51782,9 @@ var main = defineCommand({
       }
     }),
     recall: defineCommand({
-      meta: { name: "recall", description: "Search mesh memory by keyword or phrase" },
+      meta: { name: "recall", description: "Search mesh memories by keyword or phrase" },
       args: {
-        query: { type: "positional", description: "Search query", required: true },
+        query: { type: "positional", description: "Full-text search query", required: true },
         mesh: { type: "string", description: "Mesh slug (auto-selected if only one joined)" },
         json: { type: "boolean", description: "Output as JSON", default: false }
       },
@@ -51573,13 +51793,14 @@ var main = defineCommand({
       }
     }),
     remind: defineCommand({
-      meta: { name: "remind", description: "Schedule a reminder or delayed message via the broker" },
+      meta: { name: "remind", description: "Schedule a delayed message. Also: `remind list`, `remind cancel <id>`" },
       args: {
-        message: { type: "positional", description: "Message text, or: list | cancel <id>", required: false },
-        extra: { type: "positional", description: "Additional positional args", required: false },
-        in: { type: "string", description: 'Deliver after duration: "2h", "30m", "90s"' },
-        at: { type: "string", description: 'Deliver at time: "15:00" or ISO timestamp' },
-        to: { type: "string", description: "Recipient (default: self). Name, @group, pubkey, or *" },
+        message: { type: "positional", description: "Message text — or `list` / `cancel <id>` to manage reminders", required: false },
+        extra: { type: "positional", description: "Reminder ID for `cancel`", required: false },
+        in: { type: "string", description: 'Deliver after duration: `"2h"`, `"30m"`, `"90s"`' },
+        at: { type: "string", description: 'Deliver at time: `"15:00"` or ISO timestamp' },
+        cron: { type: "string", description: 'Recurring cron expression: `"0 */2 * * *"` (every 2h), `"30 9 * * 1-5"` (9:30 weekdays)' },
+        to: { type: "string", description: "Recipient (default: self). Name, `@group`, `*`, or pubkey" },
         mesh: { type: "string", description: "Mesh slug (auto-selected if only one joined)" },
         json: { type: "boolean", description: "Output as JSON", default: false }
       },
@@ -51589,31 +51810,31 @@ var main = defineCommand({
       }
     }),
     status: defineCommand({
-      meta: { name: "status", description: "Check broker reachability for each joined mesh" },
+      meta: { name: "status", description: "Check broker connectivity for each joined mesh" },
       async run() {
         await runStatus();
       }
     }),
     doctor: defineCommand({
-      meta: { name: "doctor", description: "Diagnose install, config, keypairs, and PATH" },
+      meta: { name: "doctor", description: "Diagnose install, config, keypairs, and PATH issues" },
       async run() {
         await runDoctor();
       }
     }),
     mcp: defineCommand({
-      meta: { name: "mcp", description: "Start MCP server (stdio — invoked by Claude Code, not users)" },
+      meta: { name: "mcp", description: "Start MCP server on stdio (called by Claude Code, not users)" },
       async run() {
         await startMcpServer();
       }
     }),
     "seed-test-mesh": defineCommand({
-      meta: { name: "seed-test-mesh", description: "Dev only: inject a mesh into config (skips invite flow)" },
+      meta: { name: "seed-test-mesh", description: "Dev: inject a mesh into local config, skip invite flow" },
       run({ rawArgs }) {
         runSeedTestMesh(rawArgs);
       }
     }),
     hook: defineCommand({
-      meta: { name: "hook", description: "Internal hook handler (invoked by Claude Code hooks)" },
+      meta: { name: "hook", description: "Internal: handle Claude Code hook events" },
       async run({ rawArgs }) {
         await runHook(rawArgs);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudemesh-cli",
-  "version": "0.6.8",
+  "version": "0.6.9",
   "description": "Claude Code MCP client for claudemesh — peer mesh messaging between Claude sessions.",
   "keywords": [
     "claude-code",
@@ -48,10 +48,10 @@
     "prettier": "3.6.2",
     "typescript": "5.9.3",
     "vitest": "4.0.14",
-    "@turbostarter/prettier-config": "0.1.0",
     "@turbostarter/eslint-config": "0.1.0",
-    "@turbostarter/vitest-config": "0.1.0",
-    "@turbostarter/tsconfig": "0.1.0"
+    "@turbostarter/prettier-config": "0.1.0",
+    "@turbostarter/tsconfig": "0.1.0",
+    "@turbostarter/vitest-config": "0.1.0"
   },
   "scripts": {
     "build": "bun build src/index.ts --target=node --outfile dist/index.js --banner \"#!/usr/bin/env node\" && chmod +x dist/index.js",