@shardflux/cli 0.23.0 → 0.23.1

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.23.1
+
+- Pin the Ubuntu desktop packages to 0.1.11. Read the desktop account snapshot with the selected project key so organization, usage, spend and connector metadata match the macOS Settings app, including API-key-only profiles. Optional missing metadata stays unavailable. Conversation lists support --all with bounded cursor handling; the desktop reads all pages of conversations and workspace states.
+
 ## 0.23.0 (2026-10-14)
 
 - Codex Cloud enable and setup report when a ChatGPT sign-in is required, with `codex login` and `shard setup` as the next steps. Setup offers the sign-in action.

package/README.md

@@ -6,7 +6,7 @@ Plan-derived API budgets (0.23.0+, SDK 0.27.0): `--json` error output includes `
 
 Exec survives a dropped connection (0.23.0+): a lost start response is retried with the same session ID and reattaches to the command that already started, and a cut-off JSON answer is retried within the same safe retry boundary.
 
-Suspension controls arrive in 0.22.0 (next coordinated release). `shard operations progress <operation-id>` reads the actual phase, host deadline, cancellation window and safe next action. `shard operations cancel <operation-id>` requests cancellation; `--wait --timeout 5m` waits for confirmed `suspend_canceled` recovery of the original workspace. Asynchronous acceptance is labeled separately. The owning host refuses cancellation outside validated preparation; after capture, wait for the outcome and resume if it succeeded. These commands never reset, replace or launch a provider turn. `--json` preserves the reported values; unavailable progress is explicit.
+Suspension controls are available from 0.22.0. `shard operations progress <operation-id>` reads the actual phase, host deadline, cancellation window and safe next action. `shard operations cancel <operation-id>` requests cancellation; `--wait --timeout 5m` waits for confirmed `suspend_canceled` recovery of the original workspace. Asynchronous acceptance is labeled separately. The owning host refuses cancellation outside validated preparation; after capture, wait for the outcome and resume if it succeeded. These commands never reset, replace or launch a provider turn. `--json` preserves the reported values; unavailable progress is explicit.
 
 The command line for [Shardflux](https://shardflux.dev): serverless VMs for AI agents. Open a
 persistent workspace by key, run commands in it, move files in and out, and suspend, resume, fork
@@ -188,6 +188,10 @@ you can ask the agent itself to continue in the cloud. A session is listed under
 one that began in another folder such as Claude Desktop's scratch folder, and `--path <repository>` moves it from
 anywhere (0.22.0+).
 
+With menu bar 0.8.5+, a failed move stays at its session’s row with its reason on hover and **Retry move to cloud**
+in **⋯**. Retry or Refresh clears the previous failure. CLI 0.23.0+ records a matching stable Node.js path on macOS,
+and menu bar 0.8.5+ recovers Node.js after an upgrade removes the recorded binary.
+
 Start a thread in T3 Code from the command line (0.17.0+):
 
 ```sh
@@ -1597,15 +1601,17 @@ shard agents new --app claude --path ./ --prompt "What is wrong on this page?" -
 
 `--image <file|->` (0.15.0+, repeatable) attaches up to five PNG, JPEG, GIF or WebP images of up to 10 MiB each to that first message. They are written into the conversation VM under `/home/user/.shardflux/attachments/` and named in the message: Claude Code attaches them as images and Codex opens them with its image viewer. `--image -` reads one image, or PNG images back to back, from standard input; use a file for `--prompt-file` when images come from standard input.
 
-Use `shard agents open <workspace> --in auto --json` to resolve where a conversation opens: a saved target first; then, for Claude (0.15.1+), the conversation itself in Claude Desktop when it is installed (`{"target":"claude-desktop","url":"claude://code/session_…","app_bundle_id":…}`), else Claude Code in the terminal (`{"target":"terminal","command":["shard","agents","open","<workspace>"]}`; without `--json` it attaches in this terminal). Codex opens its Cloud thread in the Codex app. claude.ai opens with `--in web`. The caller opens the `url` or app, or runs the command in a terminal. Explicit `--in terminal` retains terminal attachment. The menu uses this resolver for new and existing conversations, without provider URLs in Swift.
+With CLI 0.23.0+, a full conversation key or id opens that same Claude or Codex session from any folder, including after **Move to cloud**. A computer key opens its bound conversation.
+
+Use `shard agents open <workspace> --in auto --json` to resolve where a conversation opens: a saved target first; then, for Claude (0.15.1+), the conversation itself in Claude Desktop when it is installed (`{"target":"claude-desktop","url":"claude://code/session_…","app_bundle_id":…}`), else Claude Code in the terminal (`{"target":"terminal","command":["shard","agents","open","<workspace>"]}`; without `--json` it attaches in this terminal). Codex Cloud opens its current thread in your browser (CLI 0.23.0+). claude.ai opens with `--in web`. The caller opens the `url` or app, or runs the command in a terminal. Explicit `--in terminal` retains terminal attachment. The menu uses this resolver for new and existing conversations, without provider URLs in Swift.
 
-## Codex Cloud (0.15.0+, unreleased)
+## Codex Cloud (0.15.0+)
 
 New Codex conversations use `shard agents new --app codex --path <directory>` or `shard ./ codex`. Each gets a fresh conversation VM and a genuine Codex Cloud thread. `shard agents open <conversation-id>` opens the existing thread without waking its VM. These paths create no SSH device entries and need no pairing.
 
 `shard setup` uses your existing Codex ChatGPT login to register one executor for the account. Its small connector workspace stays resident and is billed as ordinary workspace memory/CPU usage, including while conversations wait. Use `--no-codex` to skip setup, `shard agents codex status` to inspect it, or `shard agents codex disable` to remove the executor and release its residency. Conversation VMs wake for tools and follow the normal adaptive idle policy afterwards.
 
-Explicit `agents new --in terminal`, `--in t3`, and `--like` launches keep their existing VM routes. Local Git is prepared and validated before Cloud enrollment. This branch's Cloud feature is awaiting release. Existing local-mode conversations keep their original route. Cloud uses OpenAI's model/configuration capabilities; local app-server plugins and settings are not automatically transferred.
+Explicit `agents new --in terminal`, `--in t3`, and `--like` launches keep their existing VM routes. Local Git is prepared and validated before Cloud enrollment. Existing local-mode conversations keep their original route. Cloud uses OpenAI's model/configuration capabilities; local app-server plugins and settings are not automatically transferred.
 
 Save progress (0.22.0+): Machine and template saves show source size and an estimated duration, then queued/build state and phase updates immediately. With `--json`, progress events go to stderr and the final stdout document includes `preflight` and `phases`. Failure and timeout output retain the latest counters and `details.last_progress`, with the build id and recovery action. If an older API cannot expose the build, JSON stderr emits `save_started` with the version/build id and leaves the phase unknown. Missing final host reports preserve the last observed progress.
 

package/dist/args.d.ts

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

package/dist/args.js

@@ -13,7 +13,7 @@ import { parseArgs } from 'node:util';
 import { ACCOUNT_COMMANDS } from "./account-args.js";
 import { UsageError } from "./errors.js";
 import { DEFAULT_CHOICE, MODEL_CHOICES } from "./agent-models.js";
-export const CLI_VERSION = '0.23.0';
+export const CLI_VERSION = '0.23.1';
 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).' },
@@ -146,10 +146,9 @@ const LAYER_HELP = {
     template: 'The project template is this repository’s layer: toolchains, dependencies, services and project secrets. Setup after "shard ./" saves it; "shard template save" saves the current agent VM’s project changes, and "shard template delete" starts the project over from your machine. It is saved from an agent’s VM; "shard templates" builds templates for your own app’s workspaces instead.',
 };
 const KEY_COMMANDS = [
-    { path: ['conversations', 'list'], summary: 'List project conversations', positionals: [], options: {
+    { path: ['conversations', 'list'], summary: 'List project conversations', positionals: [], options: { all: { type: 'boolean', description: 'Fetch every page.' },
             project: { type: 'string', value: '<id>', description: 'Project ID for a user session.' }, state: { type: 'string', value: '<state>', description: 'Conversation state.' },
-            parent: { type: 'string', value: '<id>', description: 'Children of this conversation.' }, limit: { type: 'string', value: '<count>', description: 'Page size.' }, cursor: { type: 'string', value: '<cursor>', description: 'Next page cursor.' }
-        } },
+            parent: { type: 'string', value: '<id>', description: 'Children of this conversation.' }, limit: { type: 'string', value: '<count>', description: 'Page size.' }, cursor: { type: 'string', value: '<cursor>', description: 'Next page cursor.' } } },
     { path: ['conversations', 'resume'], summary: 'Resume a saved conversation in a fresh VM', positionals: [{ name: 'id', required: true }], options: {} },
     { path: ['conversations', 'reader'], summary: 'Open a read-only project space reader', positionals: [{ name: 'project_id', required: true }], options: {} },
     { path: ['conversations', 'get'], summary: 'Show a conversation and its current VM', positionals: [{ name: 'id', required: true }], options: {} },
@@ -1364,10 +1363,10 @@ const CLI_PROXY_COMMANDS = [
     { path: ['cli-proxy', 'forward'], hidden: true, summary: 'Forward 127.0.0.1:8317 to your hosted CLIProxyAPI (started at login)', positionals: [], options: {} },
 ];
 /** Every command: the account plane first (sign in, set up), then the project-key commands. */
-const MENUBAR_COMMANDS = ['start', 'stop', 'status'].map(action => ({
-    path: ['menubar', action], summary: `${action === 'start' ? 'Install and start' : action === 'stop' ? 'Stop' : 'Show'} the macOS menu bar app`,
-    positionals: [], options: { login: { type: 'string', value: '<on|off>', description: 'Enable or disable launch at login.' } },
-}));
+const MENUBAR_COMMANDS = [{ path: ['menubar', 'account'], hidden: true, summary: 'Read this profile’s desktop account snapshot', positionals: [], options: {} }, ...['start', 'stop', 'status'].map((action) => ({
+        path: ['menubar', action], summary: `${action === 'start' ? 'Install and start' : action === 'stop' ? 'Stop' : 'Show'} the macOS menu bar app`,
+        positionals: [], options: { login: { type: 'string', value: '<on|off>', description: 'Enable or disable launch at login.' } },
+    }))];
 const SETTINGS_COMMANDS = [{
         path: ['settings'], summary: 'Show or change this computer’s settings for cloud conversations (0.20.1+)', positionals: [], options: {
             'title-prefix': { type: 'string', value: '<text|none|default>', description: 'The marker your cloud conversations’ Claude session titles start with in claude.ai and the Claude app ("☁ Fix login bug · todo-app"): up to 16 characters on one line; none for no marker, default for ☁. New conversations use it.' },

package/dist/conversation-commands.js

@@ -19,9 +19,23 @@ export const CONVERSATION_HANDLERS = {
     async 'conversations reader'(ctx, _values, [id]) { const r = await conversationClient(ctx).conversations.spaceReader(id, { signal: ctx.signal }); out(ctx, `${r.workspace.workspace_key}\n`, r); return 0; },
     async 'conversations list'(ctx, values) {
         const state = str(values.state);
-        const page = await conversationClient(ctx).conversations.list({ projectId: str(values.project), state, parentId: str(values.parent), cursor: str(values.cursor), limit: values.limit ? Number(values.limit) : undefined });
+        const data = [], seen = new Set();
+        let cursor = str(values.cursor), next;
+        if (cursor)
+            seen.add(cursor);
+        do {
+            const page = await conversationClient(ctx).conversations.list({ projectId: str(values.project), state, parentId: str(values.parent), cursor, limit: values.limit ? Number(values.limit) : values.all ? 200 : undefined });
+            data.push(...page.data);
+            next = page.nextCursor;
+            cursor = next ?? undefined;
+            if (values.all && cursor) {
+                if (seen.has(cursor) || seen.size >= 100)
+                    throw new UsageError('The conversation list repeated its cursor. Try again.');
+                seen.add(cursor);
+            }
+        } while (values.all && cursor);
         // A conversation that needs you adds a fifth column: why (0.18.0+).
-        out(ctx, page.data.map(c => { const q = questionLine(c); return `${c.id}\t${displayTitle(c)}\t${c.state}\t${c.branch}${q ? `\t${q}` : ''}`; }).join('\n') + '\n', page);
+        out(ctx, data.map(c => { const q = questionLine(c); return `${c.id}\t${displayTitle(c)}\t${c.state}\t${c.branch}${q ? `\t${q}` : ''}`; }).join('\n') + '\n', { data, nextCursor: next });
         return 0;
     },
     async 'conversations get'(ctx, _values, [id]) { const c = await conversationClient(ctx).conversations.get(id); const q = questionLine(c, 200); out(ctx, `${displayTitle(c)}\n${c.state}\n${c.branch}\n${q ? `${q}\n` : ''}`, c); return 0; },

package/dist/conversations.js

@@ -87,12 +87,17 @@ export async function getConversation(ctx, id) {
     return validateConversation(c);
 }
 export async function listConversations(ctx, projectId) {
-    const all = [];
+    const all = [], seen = new Set();
     let cursor;
     do {
         const page = await conversationClient(ctx).conversations.list({ ...(projectId ? { projectId } : {}), limit: 200, ...(cursor ? { cursor } : {}) });
         all.push(...page.data.map(validateConversation));
         cursor = page.nextCursor ?? undefined;
+        if (cursor) {
+            if (seen.has(cursor) || seen.size >= 100)
+                throw new UsageError('The conversation list repeated its cursor. Try again.');
+            seen.add(cursor);
+        }
     } while (cursor);
     return all;
 }

package/dist/desktop-account.d.ts

@@ -0,0 +1,16 @@
+import type { Ctx } from './commands.js';
+/** The desktop Settings snapshot uses the selected project key's organization, as AccountClient on macOS does.
+ * The optional user identity comes from the session; saved credentials never imply connector liveness. */
+export declare function desktopAccount(ctx: Ctx): Promise<{
+    identity: {
+        id: string;
+        email: string;
+        email_verified: boolean;
+        display_name: string | null;
+        mfa_enabled: boolean;
+    } | null;
+    organization: Record<string, unknown>;
+    usage: Record<string, unknown> | null;
+    spend: Record<string, unknown> | null;
+    credentials: import("@shardflux/sdk").AgentCredentialMetadata[] | null;
+}>;

package/dist/desktop-account.js

@@ -0,0 +1,29 @@
+import { UsageError } from "./errors.js";
+/** The desktop Settings snapshot uses the selected project key's organization, as AccountClient on macOS does.
+ * The optional user identity comes from the session; saved credentials never imply connector liveness. */
+export async function desktopAccount(ctx) {
+    const token = ctx.apiKey().token;
+    const request = async (path) => {
+        const response = await (ctx.accountOptions().fetch ?? fetch)(new URL(`v1/${path}`, `${ctx.apiUrl.replace(/\/+$/, '')}/`), {
+            headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' }, redirect: 'error',
+            signal: AbortSignal.any([ctx.signal, AbortSignal.timeout(20_000)]),
+        });
+        if (!response.ok)
+            throw new UsageError(`Couldn’t refresh your account (${response.status}). Try again.`);
+        return await response.json();
+    };
+    const me = await ctx.cloud().me();
+    const org = me.api_key?.organization_id;
+    if (!org)
+        throw new UsageError('The project key did not identify its organization. Sign in to Shardflux again.');
+    const [organization, usage, spend, credentials, identity] = await Promise.all([
+        request(`organizations/${encodeURIComponent(org)}`),
+        request(`organizations/${encodeURIComponent(org)}/usage/summary`).catch(() => null),
+        request(`organizations/${encodeURIComponent(org)}/spend`).catch(() => null),
+        ctx.cloud().agentCredentials.list().catch(() => null),
+        ctx.sessionSource() ? ctx.account().me().then(value => value.user).catch(() => null) : Promise.resolve(null),
+    ]);
+    if (organization.id !== org || typeof organization.name !== 'string' || !organization.name)
+        throw new UsageError('The organization response is unreadable. Refresh your account and try again.');
+    return { identity, organization, usage, spend, credentials };
+}

package/dist/menubar.js

@@ -1,3 +1,4 @@
+import { desktopAccount } from "./desktop-account.js";
 import { execFile, spawn } from 'node:child_process';
 import { chmodSync, closeSync, cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, openSync, readdirSync, readFileSync, renameSync, rmSync, writeSync } from 'node:fs';
 import { createRequire } from 'node:module';
@@ -492,3 +493,4 @@ export const MENUBAR_HANDLERS = Object.fromEntries(['start', 'stop', 'status'].m
     };
     return [`menubar ${action}`, handler];
 }));
+MENUBAR_HANDLERS['menubar account'] = async (ctx) => { ctx.io.stdout.write(json(await desktopAccount(ctx))); return 0; };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shardflux/cli",
-  "version": "0.23.0",
+  "version": "0.23.1",
   "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",
@@ -58,8 +58,8 @@
     "typescript-eslint": "8.70.1"
   },
   "optionalDependencies": {
-    "@shardflux/desktop-linux-x64": "0.1.10",
-    "@shardflux/desktop-linux-arm64": "0.1.10",
+    "@shardflux/desktop-linux-x64": "0.1.11",
+    "@shardflux/desktop-linux-arm64": "0.1.11",
     "@shardflux/menubar-darwin": "^0.8.5"
   },
   "scripts": {