claudemesh-cli 0.6.7 → 0.6.9

package/LICENSE.md

@@ -0,0 +1,37 @@
+MIT License
+
+Copyright (c) 2026 alezmad (claudemesh)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+---
+
+## Attribution
+
+This project was originally scaffolded using TurboStarter (https://turbostarter.dev),
+a proprietary SaaS starter kit. The TurboStarter scaffold code is covered by
+your separate purchase agreement with TurboStarter and is NOT re-licensed by
+this MIT license. The MIT license above covers claudemesh-specific additions,
+modifications, and original code written on top of that scaffold — including
+but not limited to: apps/broker, apps/cli, apps/web/src/modules/marketing/home,
+packages/db/src/schema/mesh.ts, the protocol, and the documentation.
+
+If you are redistributing this repository, you are responsible for compliance
+with BOTH the TurboStarter EULA (for scaffold components) and this MIT license
+(for claudemesh code).

package/dist/index.js

@@ -47376,31 +47376,22 @@ var TOOLS = [
   },
   {
     name: "schedule_reminder",
-    description: "Schedule a reminder message delivered back to yourself at a future time. The broker fires it as a push when the time arrives. Use to prompt yourself to check on something later.",
+    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: "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" }
+        message: { type: "string", description: "Message or reminder text" },
+        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)"
+        }
       },
       required: ["message"]
     }
   },
-  {
-    name: "send_later",
-    description: "Send a message to a peer, @group, or broadcast (*) at a future time. The broker holds it and delivers when the time arrives.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        to: { type: "string", description: "Recipient: display name, pubkey hex, @group, or *" },
-        message: { type: "string", description: "Message 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" }
-      },
-      required: ["to", "message"]
-    }
-  },
   {
     name: "list_scheduled",
     description: "List all your pending scheduled messages: id, recipient, preview, and delivery time.",
@@ -47575,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
           }));
@@ -47783,7 +47777,7 @@ class BrokerClient {
       return;
     this.ws.send(JSON.stringify({ type: "forget", memoryId }));
   }
-  async scheduleMessage(to, message, deliverAt) {
+  async scheduleMessage(to, message, deliverAt, isReminder = false, cron) {
     if (!this.ws || this.ws.readyState !== this.ws.OPEN)
       return null;
     return new Promise((resolve) => {
@@ -47792,7 +47786,15 @@ class BrokerClient {
         if (this.scheduledAckResolvers.delete(reqId))
           resolve(null);
       }, 8000) });
-      this.ws.send(JSON.stringify({ type: "schedule", to, message, deliverAt, _reqId: reqId }));
+      this.ws.send(JSON.stringify({
+        type: "schedule",
+        to,
+        message,
+        deliverAt,
+        ...isReminder ? { subtype: "reminder" } : {},
+        ...cron ? { cron, recurring: true } : {},
+        _reqId: reqId
+      }));
     });
   }
   async listScheduled() {
@@ -48236,7 +48238,10 @@ class BrokerClient {
           createdAt: String(msg.createdAt ?? ""),
           receivedAt: new Date().toISOString(),
           plaintext,
-          kind
+          kind,
+          ...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)
@@ -48404,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;
     }
@@ -48631,7 +48637,8 @@ function decryptFailedWarning(senderPubkey) {
 }
 function formatPush(p, meshSlug) {
   const body = p.plaintext ?? decryptFailedWarning(p.senderPubkey);
-  return `[${meshSlug}] from ${p.senderPubkey.slice(0, 12)}… (${p.priority}, ${p.createdAt}):
+  const tag = p.subtype === "reminder" ? " [REMINDER]" : "";
+  return `[${meshSlug}]${tag} from ${p.senderPubkey.slice(0, 12)}… (${p.priority}, ${p.createdAt}):
 ${body}`;
 }
 async function startMcpServer() {
@@ -48651,6 +48658,8 @@ You are "${myName}"${myRole ? ` (${myRole})` : ""} — a peer in the claudemesh
 ## Responding to messages
 When you receive a <channel source="claudemesh" ...> message, RESPOND IMMEDIATELY. Pause your current task, reply via send_message, then resume. Read from_name, mesh_slug, and priority from the channel attributes. Reply by setting \`to\` to the sender's from_name (display name). Stay in character per your system prompt. Do not ignore low-priority messages — acknowledge them briefly even if you defer action.
 
+If the channel meta contains \`subtype: reminder\`, this is a scheduled reminder you set for yourself — act on it immediately (no reply needed).
+
 ## Tools
 | Tool | Description |
 |------|-------------|
@@ -48692,6 +48701,9 @@ When you receive a <channel source="claudemesh" ...> message, RESPOND IMMEDIATEL
 | claim_task(id) | Claim an unclaimed task. |
 | complete_task(id, result?) | Mark task done with optional result. |
 | list_tasks(status?, assignee?) | List tasks filtered by status/assignee. |
+| schedule_reminder(message, in_seconds?, deliver_at?, to?) | Schedule a reminder to yourself (no \`to\`) or a delayed message to a peer/group. Delivered as a push with \`subtype: reminder\` in the channel meta. |
+| list_scheduled() | List pending scheduled reminders and messages. |
+| cancel_scheduled(id) | Cancel a pending scheduled item. |
 
 If multiple meshes are joined, prefix \`to\` with \`<mesh-slug>:\` to disambiguate (e.g. \`dev-team:Alice\`).
 
@@ -48801,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(`
@@ -48950,40 +48971,48 @@ ${lines.join(`
         await client2.forget(id);
         return text(`Forgotten: ${id}`);
       }
-      case "schedule_reminder":
-      case "send_later": {
+      case "schedule_reminder": {
         const sArgs = args ?? {};
         if (!sArgs.message)
-          return text(`${name}: \`message\` required`, true);
-        const to = name === "schedule_reminder" ? "self" : sArgs.to ?? "";
-        if (name === "send_later" && !to)
-          return text("send_later: `to` required", true);
+          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(`${name}: provide \`deliver_at\` (ms timestamp) or \`in_seconds\``, true);
-        }
-        let targetSpec = to;
-        if (name === "send_later" && !to.startsWith("@") && to !== "*" && !/^[0-9a-f]{64}$/i.test(to) && to !== "self") {
-          const peers = await client.listPeers();
-          const match = peers.find((p) => p.displayName.toLowerCase() === to.toLowerCase());
-          if (!match) {
-            const names = peers.map((p) => p.displayName).join(", ");
-            return text(`send_later: peer "${to}" not found. Online: ${names || "(none)"}`, true);
-          }
-          targetSpec = match.pubkey;
+          return text("schedule_reminder: provide `deliver_at` (ms timestamp), `in_seconds`, or `cron` expression", true);
         }
-        if (name === "schedule_reminder") {
+        const isSelf = !sArgs.to;
+        let targetSpec;
+        if (isSelf) {
           targetSpec = client.getSessionPubkey() ?? "*";
+        } else {
+          const to = sArgs.to;
+          if (!to.startsWith("@") && to !== "*" && !/^[0-9a-f]{64}$/i.test(to)) {
+            const peers = await client.listPeers();
+            const match = peers.find((p) => p.displayName.toLowerCase() === to.toLowerCase());
+            if (!match) {
+              const names = peers.map((p) => p.displayName).join(", ");
+              return text(`schedule_reminder: peer "${to}" not found. Online: ${names || "(none)"}`, true);
+            }
+            targetSpec = match.pubkey;
+          } else {
+            targetSpec = to;
+          }
         }
-        const result = await client.scheduleMessage(targetSpec, sArgs.message, deliverAt);
+        const result = await client.scheduleMessage(targetSpec, sArgs.message, deliverAt, true, sArgs.cron);
         if (!result)
-          return text(`${name}: broker did not acknowledge — check connection`, true);
+          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(name === "schedule_reminder" ? `Reminder scheduled (${result.scheduledId.slice(0, 8)}): "${sArgs.message.slice(0, 60)}" at ${when}` : `Message to "${to}" scheduled (${result.scheduledId.slice(0, 8)}) for ${when}`);
+        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}`);
       }
       case "list_scheduled": {
         const scheduled = await client.listScheduled();
@@ -49497,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") {
@@ -49525,7 +49587,8 @@ ${rows.join(`
               priority: msg.priority,
               sent_at: msg.createdAt,
               delivered_at: msg.receivedAt,
-              kind: msg.kind
+              kind: msg.kind,
+              ...msg.subtype ? { subtype: msg.subtype } : {}
             }
           }
         });
@@ -49719,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();
@@ -50553,7 +50620,7 @@ init_config();
 // package.json
 var package_default = {
   name: "claudemesh-cli",
-  version: "0.6.7",
+  version: "0.6.9",
   description: "Claude Code MCP client for claudemesh — peer mesh messaging between Claude sessions.",
   keywords: [
     "claude-code",
@@ -51019,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("");
   });
@@ -51307,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) => {
@@ -51333,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);
@@ -51342,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",
@@ -51377,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
     }
   },
@@ -51402,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": {
@@ -51418,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
     }
   },
@@ -51434,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
     }
   },
@@ -51455,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 }
@@ -51481,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 }
       },
@@ -51544,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 }) {
@@ -51556,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 }
       },
@@ -51567,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 }
       },
@@ -51583,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.7",
+  "version": "0.6.9",
   "description": "Claude Code MCP client for claudemesh — peer mesh messaging between Claude sessions.",
   "keywords": [
     "claude-code",
@@ -30,17 +30,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "bun build src/index.ts --target=node --outfile dist/index.js --banner \"#!/usr/bin/env node\" && chmod +x dist/index.js",
-    "clean": "git clean -xdf .cache .turbo dist node_modules",
-    "dev": "bun --hot src/index.ts",
-    "start": "bun src/index.ts",
-    "format": "prettier --check . --ignore-path ../../.gitignore",
-    "lint": "eslint",
-    "prepublishOnly": "bun run build",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit"
-  },
   "prettier": "@turbostarter/prettier-config",
   "engines": {
     "node": ">=20"
@@ -53,15 +42,25 @@
     "zod": "4.1.13"
   },
   "devDependencies": {
-    "@turbostarter/eslint-config": "workspace:*",
-    "@turbostarter/prettier-config": "workspace:*",
-    "@turbostarter/tsconfig": "workspace:*",
-    "@turbostarter/vitest-config": "workspace:*",
     "@types/libsodium-wrappers": "0.7.14",
     "@types/ws": "8.5.13",
-    "eslint": "catalog:",
-    "prettier": "catalog:",
-    "typescript": "catalog:",
-    "vitest": "catalog:"
+    "eslint": "9.39.0",
+    "prettier": "3.6.2",
+    "typescript": "5.9.3",
+    "vitest": "4.0.14",
+    "@turbostarter/eslint-config": "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",
+    "clean": "git clean -xdf .cache .turbo dist node_modules",
+    "dev": "bun --hot src/index.ts",
+    "start": "bun src/index.ts",
+    "format": "prettier --check . --ignore-path ../../.gitignore",
+    "lint": "eslint",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
   }
-}
+}