@shardflux/cli 0.14.3 → 0.14.4

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.14.4
+
+- `shard <path> --codex` and `--claude` choose the agent like `shard <path> codex` and `claude`. An unknown option or app on `shard <path>` names the right form, e.g. `shard ./ codex`.
+
 ## 0.14.3
 
 - Poll device requests and deliver approvals independently of transcript mirroring, so a slow or failed copy cannot delay file-push approvals. Isolate mirror failures by conversation, retry with exponential backoff, and log each failure once per conversation revision with the affected entry name.

package/README.md

@@ -1163,7 +1163,7 @@ as ordinary files. Browser logins and Claude/Codex config belong to the machine.
 your agent uses the same save/rollback commands there. Every agent starts from both. Save or roll back with `shard machine save|rollback` and
 `shard template save|rollback`; changed files reach running agents live, software at the next start.
 `shard machine save --wait` and `shard template save --wait` return once the new version is ready (0.13.3+).
-`shard ./ codex` (or `claude`) starts that agent directly; `shard agents targets <project>/<agent>` lists each
+`shard ./ codex` (or `claude`; `--codex` and `--claude` also work, 0.14.4+) starts that agent directly; `shard agents targets <project>/<agent>` lists each
 connection it configured and the file it is in (0.13.3+).
 
 `shard agents fork` or `f` in the command center copies the whole running state into an independent workspace and

package/dist/args.d.ts

@@ -1,4 +1,4 @@
-export declare const CLI_VERSION = "0.14.3";
+export declare const CLI_VERSION = "0.14.4";
 export interface OptionSpec {
     type: 'string' | 'boolean';
     short?: string;

package/dist/args.js

@@ -12,7 +12,7 @@
 import { parseArgs } from 'node:util';
 import { ACCOUNT_COMMANDS } from "./account-args.js";
 import { UsageError } from "./errors.js";
-export const CLI_VERSION = '0.14.3';
+export const CLI_VERSION = '0.14.4';
 export const GLOBAL_OPTIONS = {
     'api-url': { type: 'string', value: '<url>', description: 'API base URL (default $SHARDFLUX_API_URL, else https://api.shardflux.dev).' },
     json: { type: 'boolean', description: 'Print machine-readable JSON on stdout (errors as JSON on stderr).' },
@@ -1173,8 +1173,19 @@ const AGENT_OPTIONS = {
 export const PROJECT_COMMAND = {
     path: ['<path>'], summary: 'Start a conversation in its own cloud VM',
     description: 'Opens Claude Code or Codex directly. --resume continues a project conversation. With --json it starts detached and prints the session. Detach with Ctrl-] then d.',
-    positionals: [{ name: 'path', required: true }, { name: 'claude|codex' }], options: { ...AGENT_OPTIONS, new: { type: 'boolean', description: 'Start a new conversation.' }, resume: { type: 'boolean', description: 'Continue a conversation from this project.' } },
+    positionals: [{ name: 'path', required: true }, { name: 'claude|codex' }], options: {
+        ...AGENT_OPTIONS,
+        new: { type: 'boolean', description: 'Start a new conversation.' },
+        resume: { type: 'boolean', description: 'Continue a conversation from this project.' },
+        claude: { type: 'boolean', description: 'Same as the claude argument (0.14.4+).' },
+        codex: { type: 'boolean', description: 'Same as the codex argument (0.14.4+).' },
+    },
 };
+/** `shard ./ codex`, quoting the path the way it was given when a shell would need it. */
+function projectExample(rest, app) {
+    const path = rest.find((r, i) => !r.startsWith('-') && !GLOBAL_VALUE_FLAGS.has(rest[i - 1] ?? '')) ?? './';
+    return `shard ${/^[\w./~@:+,=-]+$/.test(path) ? path : `'${path.replaceAll("'", `'\\''`)}'`} ${app}`;
+}
 export const CENTER_COMMAND = { path: ['<center>'], summary: 'Open the cloud agent command center', positionals: [], options: {} };
 const AGENT_COMMANDS = [
     { path: ['conversations', 'try'], summary: 'Try a conversation in a synced local worktree', positionals: [{ name: 'conversation', required: true }], options: { path: { type: 'string', value: '<path>', description: 'Local project checkout.' }, stop: { type: 'boolean', description: 'Stop the device helper’s local sync and ports.' } } },
@@ -1479,6 +1490,9 @@ export function parseCommandLine(argv, options = {}) {
         });
     }
     catch (err) {
+        const unknown = command === PROJECT_COMMAND && err.code === 'ERR_PARSE_ARGS_UNKNOWN_OPTION' ? /'([^']+)'/.exec(String(err.message))?.[1] : undefined;
+        if (unknown !== undefined)
+            throw new UsageError(`unknown option "${unknown}" for "shard <path>"; choose the agent with "${projectExample(rest, 'codex')}" or "${projectExample(rest, 'claude')}"`);
         throw new UsageError(err instanceof Error ? err.message : String(err));
     }
     const values = parsed.values;
@@ -1487,8 +1501,20 @@ export function parseCommandLine(argv, options = {}) {
     if (values.version === true)
         return { kind: 'version' };
     const positionals = parsed.positionals;
-    if (command === PROJECT_COMMAND && positionals[1] !== undefined && !['claude', 'codex'].includes(positionals[1]))
-        throw new UsageError('agent app must be claude or codex');
+    if (command === PROJECT_COMMAND) {
+        // --claude and --codex are spellings of the app argument; the handler only sees the argument.
+        const flagged = ['claude', 'codex'].filter((app) => values[app] === true);
+        delete values.claude;
+        delete values.codex;
+        if (positionals[1] !== undefined && !['claude', 'codex'].includes(positionals[1])) {
+            throw new UsageError(`agent app must be claude or codex, as in "${projectExample(rest, 'codex')}"`);
+        }
+        const chosen = new Set([...flagged, ...(positionals[1] === undefined ? [] : [positionals[1]])]);
+        if (chosen.size > 1)
+            throw new UsageError(`choose one agent app: "${projectExample(rest, 'codex')}" or "${projectExample(rest, 'claude')}"`);
+        if (positionals[1] === undefined && flagged[0] !== undefined && positionals.length === 1)
+            positionals.push(flagged[0]);
+    }
     const specs = command.positionals;
     const variadic = specs.at(-1)?.variadic === true;
     const required = specs.filter((s) => s.required && !s.variadic).length;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shardflux/cli",
-  "version": "0.14.3",
+  "version": "0.14.4",
   "type": "module",
   "description": "shard: the Shardflux command line. Create an account, sign in, set up keys and billing, then open, run commands in, move files to, suspend, resume and fork serverless agent workspaces.",
   "license": "Apache-2.0",