clideck 1.31.22 → 1.31.23

package/bin/clideck.js

@@ -29,11 +29,17 @@ function usage() {
     'Ask behavior:',
     '  Unscoped target lookup is limited to the same project as the caller session.',
     '  Cross-project asks must use an explicit @project/session target.',
+    '  Use the target exactly as shown by `clideck agents`; quote it if it contains spaces.',
     '  CliDeck sends the message into the real target terminal, presses Enter, waits for the',
     '  target to finish, then prints the target agent response to stdout.',
     '  The target is another LLM agent. It may need minutes to think, read files, and use tools.',
-    '  Set both `--timeout` and your shell/tool-call timeout high enough, or your caller may exit',
-    '  before the target agent finishes.',
+    '  Keep the `clideck ask` shell command running until it exits. stdout is the response channel.',
+    '  Waiting progress goes to stderr; the target response goes to stdout.',
+    '  Set both `--timeout` and your shell/tool-call timeout high enough, or the target may keep',
+    '  working while the caller loses the response.',
+    '  CliDeck only sends to idle targets and does not queue asks. If the target is busy, retry',
+    '  later or ask another idle agent.',
+    '  To ask multiple agents, run one `clideck ask` command per target and keep each one open.',
     '',
     'Examples:',
     '  clideck agents',
@@ -48,8 +54,7 @@ function usage() {
     '  Run `clideck agents` to discover available same-project sessions.',
     '  Run `clideck agents --all` before a cross-project ask.',
     '  Run `clideck ask --help` for the exact ask command contract.',
-    '  If the target name has spaces, quote it.',
-    '  If several sessions have the same name in the same project, use the session id.',
+    '  If a target has spaces, quote the whole target, including @project/session addresses.',
   ].join('\n');
 }
 

package/clideck-agents-cli.js

@@ -9,6 +9,7 @@ function usage() {
     'Lists active CliDeck sessions in the same project as the caller session.',
     'Use this from inside a CliDeck session before `clideck ask` to discover target names.',
     'Use --all to discover cross-project targets and their @project/session ask addresses.',
+    'Use the printed ask= value exactly when present, and prefer idle targets for `clideck ask`.',
     '',
     'Options:',
     '  --json       Print machine-readable JSON.',

package/clideck-ask-cli.js

@@ -13,12 +13,19 @@ function usage() {
     'Unscoped target lookup is limited to the same project as the caller session.',
     'Use @project/session only when you intentionally need to ask across projects.',
     'Run `clideck agents` or `clideck agents --all` first to discover available target sessions.',
+    'Copy and use the target exactly as listed by `clideck agents`; quote it if it contains spaces.',
     '',
     'Important for agents:',
     '  The target is another LLM agent, not a fast CLI command. It may need minutes to read files,',
-    '  think, use tools, and answer. Set BOTH the `clideck ask --timeout` value and your own',
-    '  shell/tool-call timeout high enough. If your shell tool kills this process first, the target',
-    '  agent may keep working but you will lose the response.',
+    '  think, use tools, and answer.',
+    '  Keep this shell command running until it exits. The target agent response is returned through',
+    '  this command\'s stdout; if you background it, stop watching it, or let your shell/tool timeout',
+    '  kill it, the target may keep working but you will lose the response channel.',
+    '  Set BOTH `clideck ask --timeout` and your own shell/tool-call timeout high enough.',
+    '  Waiting progress is printed to stderr; the target response is printed to stdout.',
+    '  CliDeck only sends to idle target agents. If the target is busy, the ask fails immediately;',
+    '  it is not queued. Try again later or ask another idle agent.',
+    '  To ask multiple agents, start one `clideck ask` command per target and keep each command open.',
     '',
     'Options:',
     '  -s, --session <name-or-id>  Target session name or id.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clideck",
-  "version": "1.31.22",
+  "version": "1.31.23",
   "description": "One screen for all your AI coding agents — run, monitor, and manage multiple CLI agents from a single browser tab",
   "main": "server.js",
   "bin": {