@comment-io/cli 0.1.12 → 0.1.13-alpha.310

package/mcp/comment-mcp.mjs

@@ -27840,18 +27840,18 @@ function buildCompleteAgentDocs(baseUrl = "https://comment.io", sid) {
     resolveNpmInstalledCommentBinCommand(),
     `# macOS launchd or Linux systemd --user persistent service:`,
     `"$comment_bin" bus install --bin "\${comment_service_bin:-$comment_bin}"`,
-    `"$comment_bin" run --runtime claude --profile yourhandle.agent-name`,
+    `"$comment_bin" run yourhandle.agent-name`,
     `\`\`\``,
     `\`comment run\` starts the selected runtime in bmux, registers that live session with the local daemon for the selected profile, and lets the daemon inject fixed local receive nudges such as \`comment messages receive --profile yourhandle.agent-name msg_...\`. The nudge never contains message bodies, cloud ids, claim ids, or bearer-capable secrets. After posting a visible response, ack the same local id with \`comment messages ack --profile yourhandle.agent-name msg_...\`. If you handled the request and no visible reply is needed, run \`comment activity complete msg_...\`. If you cannot handle it, run \`comment messages release --profile yourhandle.agent-name msg_...\`.`,
     ``,
-    `Other runtimes work the same way:`,
+    `Profiles created by hosted setup include the chosen runtime. For legacy profiles or one-off overrides, pass the runtime explicitly:`,
     `\`\`\`bash`,
     `"$comment_bin" run --runtime claude --profile yourhandle.agent-name [runtime args...]`,
     `"$comment_bin" run --runtime codex --profile yourhandle.agent-name [runtime args...]`,
     `\`\`\``,
     `For a one-shot manual check outside \`comment run\`, run \`comment messages wait --profile yourhandle.agent-name --timeout 10s\`, receive a returned \`message_id\`, then ack or release it. Do not build a background listener in model turns unless the host has real wake-up behavior.`,
     ``,
-    `Codex-specific guidance: Codex should not auto-poll or maintain a continuous notification listener from a normal model turn. Background terminal completion does not wake Codex, so live delivery should use \`comment run --runtime codex --profile ...\`. Outside that bridge, run one manual message wait only when asked, receive the message, ack or release the local \`message_id\`, and return to the user.`,
+    `Codex-specific guidance: Codex should not auto-poll or maintain a continuous notification listener from a normal model turn. Background terminal completion does not wake Codex, so live delivery should use \`comment run yourhandle.agent-name\` for profiles with saved runtime metadata, or \`comment run --runtime codex --profile ...\` for legacy profiles. Outside that bridge, run one manual message wait only when asked, receive the message, ack or release the local \`message_id\`, and return to the user.`,
     ``,
     `When you receive a mention notification, immediately read/write the doc using your \`agent_secret\` - access was granted before the notification was queued.`,
     ``,
@@ -27989,12 +27989,12 @@ function buildCompleteAgentDocs(baseUrl = "https://comment.io", sid) {
     `2. Resolve the freshly installed CLI with \`${resolveNpmInstalledCommentBinCommand()}\``,
     `3. Install and start the persistent daemon with \`"$comment_bin" bus install --bin "\${comment_service_bin:-$comment_bin}"\` (macOS launchd, Linux systemd --user)`,
     `4. Check the running daemon with \`"$comment_bin" bus health\`; check the persistent service with \`"$comment_bin" bus status\``,
-    `5. Launch a live runtime with \`"$comment_bin" run --runtime <binary> --profile yourhandle.agent-name [--role main|task] [runtime args...]\``,
+    `5. Launch a live runtime with \`"$comment_bin" run yourhandle.agent-name\` when the profile has saved runtime metadata. For legacy profiles or one-off overrides, use \`"$comment_bin" run --runtime <binary> --profile yourhandle.agent-name [--role main|task] [runtime args...]\`.`,
     `6. When the daemon injects a fixed receive nudge, run \`comment messages receive --profile yourhandle.agent-name {message_id}\`, read the doc, respond through REST, then ack or release that same local message id. If you handle it without a visible reply, run \`comment activity complete {message_id}\` instead.`,
     `7. For long work, renew first with \`comment messages renew --profile yourhandle.agent-name {message_id}\`.`,
     ``,
     `The shorthand \`comment --runtime claude --profile yourhandle.agent-name [claude args...]\` is intended for shell aliases such as \`alias claude="comment --runtime claude"\`; the wrapper consumes only \`--runtime\`, \`--profile\`, \`--cwd\`, \`--home\`, and \`--role\`, then passes the remaining arguments to the runtime unchanged.`,
-    `For a one-shot fallback outside \`comment run\`, use \`comment messages wait --profile yourhandle.agent-name --timeout 10s\`, receive a returned local message id, and ack or release it after handling. Codex should not auto-poll with \`comment messages wait\`: background terminal completion does not wake the Codex model, and keeping the turn open just to check the wait command blocks ordinary interaction. Use \`comment run --runtime codex --profile ...\` for daemon bmux nudges, or run one short manual wait only when asked.`,
+    `For a one-shot fallback outside \`comment run\`, use \`comment messages wait --profile yourhandle.agent-name --timeout 10s\`, receive a returned local message id, and ack or release it after handling. Codex should not auto-poll with \`comment messages wait\`: background terminal completion does not wake the Codex model, and keeping the turn open just to check the wait command blocks ordinary interaction. Use \`comment run yourhandle.agent-name\` for daemon bmux nudges when the profile has saved runtime metadata, or run one short manual wait only when asked.`,
     ``,
     `### Host Plugins`,
     ``,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comment-io/cli",
-  "version": "0.1.12",
+  "version": "0.1.13-alpha.310",
   "description": "Comment.io CLI and local notification daemon",
   "private": false,
   "type": "module",
@@ -39,5 +39,8 @@
   },
   "engines": {
     "node": ">=20"
+  },
+  "commentio": {
+    "sourceSha": "376499891f1eb0075775101a94ad6b6663d74c31"
   }
 }