@phnx-labs/agents-cli 1.22.46 → 1.22.49

package/dist/commands/go.js

@@ -30,7 +30,8 @@ import { machineId } from '../lib/session/sync/config.js';
 import { attachTmux, runTmux } from '../lib/tmux/binary.js';
 import { ensureSessionHookRepaired, paneExitStatus } from '../lib/tmux/session.js';
 import { getDefaultSocketPath } from '../lib/tmux/paths.js';
-import { sshExec, sshStream, assertValidSshTarget, shellQuote } from '../lib/ssh-exec.js';
+import { sshExec, sshStream, assertValidSshTarget, shellQuote, SSH_CONN_FAILURE_CODE } from '../lib/ssh-exec.js';
+import { connectionEndedNotice } from '../lib/hosts/reconnect.js';
 import { enumerateGhosttyTabs, assignGhosttyTabs } from '../lib/session/ghostty-tabs.js';
 const execFileAsync = promisify(execFile);
 export function registerGoCommand(program) {
@@ -191,6 +192,13 @@ function synthMeta(s, self) {
 function shortId(s) {
     return (s.sessionId ?? '').slice(0, 8) || '-';
 }
+/** What `jumpTo` writes after a remote tmux attach's SSH stream returns. Pure so
+ *  the ControlMaster close path is unit-tested without SSH (RUSH-3227). */
+export function remoteAttachEndedNotice(sessionId, host, code) {
+    if (!sessionId)
+        return undefined;
+    return connectionEndedNotice({ kind: 'session', id: sessionId }, host, { dropped: code === SSH_CONN_FAILURE_CODE });
+}
 /**
  * Pure, testable mirror of `jumpTo`'s path selection (jumpTo itself has side
  * effects — process.exit / ssh / osascript). Keep the branch ORDER in sync with
@@ -276,8 +284,13 @@ export async function jumpTo(s, self, fallback = refuseFallback) {
                 `sess=$(tmux ${sock}display-message -pt ${p} '#{session_name}' 2>/dev/null); ` +
                 `[ -n "$w" ] && tmux ${sock}select-window -t "$w" 2>/dev/null; ` +
                 `exec tmux ${sock}attach-session -t "\${sess:-${p}}"`;
-            console.log(chalk.gray(`Attaching ${shortId(s)} on ${remote} over SSH — Ctrl-b d to detach.`));
-            process.exit(sshStream(remote, remoteCmd, { tty: true }));
+            const attachId = s.sessionId || shortId(s);
+            console.log(chalk.gray(`Attaching ${attachId} on ${remote} over SSH — Ctrl-b d to detach.`));
+            const code = sshStream(remote, remoteCmd, { tty: true });
+            const notice = remoteAttachEndedNotice(s.sessionId, remote, code);
+            if (notice)
+                process.stderr.write(notice);
+            process.exit(code);
         }
         // Remote, not in tmux → hand off to the fallback (go: shell; focus: resume in a tab).
         await fallback(s, remote);

package/dist/commands/insights.d.ts

@@ -14,7 +14,7 @@
  *
  *   agents insights cost    what you spent ($ and duration)
  *   agents insights output  what shipped (burn vs PRs and commits)
- *   agents usage            live quota headroom
+ *   agents view             live quota headroom (per account, with auth state)
  *   agents perf             latency (hooks, CLI commands, agent.run) — not popularity
  *   agents sessions stats   which skills/slash-commands were explicitly invoked
  *

package/dist/commands/insights.js

@@ -14,7 +14,7 @@
  *
  *   agents insights cost    what you spent ($ and duration)
  *   agents insights output  what shipped (burn vs PRs and commits)
- *   agents usage            live quota headroom
+ *   agents view             live quota headroom (per account, with auth state)
  *   agents perf             latency (hooks, CLI commands, agent.run) — not popularity
  *   agents sessions stats   which skills/slash-commands were explicitly invoked
  *
@@ -577,7 +577,7 @@ function configureInsightsCommand(cmd) {
       Two paths under one verb:
         bare \`agents insights\`     — transcript behaviour (tools, friction, rhythm, by account)
         \`agents insights mix\`      — cheap counters from sessions.db + usage.db
-      Latency is \`agents perf\` (not mix). Quota is \`agents usage\`. Spend is
+      Latency is \`agents perf\` (not mix). Quota is \`agents view\`. Spend is
       \`agents insights cost\`; shipped output is \`agents insights output\`. Skill/slash popularity
       is \`agents sessions stats\`. Former top-level \`agents trends\` is \`agents insights mix\`
       (also \`agents insights trends\`).

package/dist/commands/inspect.js

@@ -274,8 +274,8 @@ function isDotAgentsRoot(dir) {
     for (const kind of DRILLABLE_KINDS) {
         // `routines/` alone is NOT a marker. Shipping example routine YAML for
         // `agents routines add` is a documented pattern (this repo's own
-        // apps/cli/routines/), and that directory is the ONLY kind dir there — so
-        // counting it would make `agents inspect apps/cli` resolve a source tree as
+        // cli/routines/), and that directory is the ONLY kind dir there — so
+        // counting it would make `agents inspect cli` resolve a source tree as
         // a DotAgents repo. Same reasoning as the nested-`.agents/` case above.
         if (kind === 'routines')
             continue;

package/dist/commands/lease.d.ts

@@ -1,7 +1,7 @@
 /**
  * `agents devices lease` — manage the disposable cloud boxes used by `agents run --lease`.
  *
- * Today: `agents devices lease gc`, which stops expired + idle "orphan" boxes that are
+ * Today: `agents devices lease prune`, which stops expired + idle "orphan" boxes that are
  * holding a provider's server quota (the cause of the `server_limit` 403 a new
  * lease hits). Reaping is conservative: only boxes whose lease has expired AND
  * that have been untouched for a safety window are eligible (see `isReapSafe`),

package/dist/commands/lease.js

@@ -1,14 +1,14 @@
 /**
  * `agents devices lease` — manage the disposable cloud boxes used by `agents run --lease`.
  *
- * Today: `agents devices lease gc`, which stops expired + idle "orphan" boxes that are
+ * Today: `agents devices lease prune`, which stops expired + idle "orphan" boxes that are
  * holding a provider's server quota (the cause of the `server_limit` 403 a new
  * lease hits). Reaping is conservative: only boxes whose lease has expired AND
  * that have been untouched for a safety window are eligible (see `isReapSafe`),
  * so a box a concurrent run just reused is never stopped.
  */
 import chalk from 'chalk';
-import { openUrl } from '../lib/open-url.js';
+import { showUrl } from '../lib/open-url.js';
 import { crabboxList, crabboxStop, reapSafeOrphans, reapOrphans, setLeaseSecretsBundle } from '../lib/crabbox/cli.js';
 import { isInteractiveTerminal, isPromptCancelled } from './utils.js';
 import { bundleExists, readBundle, writeBundle, keychainRef, bundleItemStore } from '../lib/secrets/bundles.js';
@@ -94,7 +94,7 @@ async function captureTailscaleAuthKey() {
     const { password } = await import('@inquirer/prompts');
     let key;
     try {
-        openUrl(TAILSCALE_KEYS_URL);
+        await showUrl(TAILSCALE_KEYS_URL);
         key = (await password({ message: 'Paste a Tailscale auth key (blank to skip):', mask: true })).trim();
     }
     catch (e) {
@@ -155,7 +155,7 @@ export async function runLeaseSetup(opts = {}) {
     console.error(chalk.bold('\nSet up leasing (Hetzner) — one time (~30s):'));
     console.error(chalk.dim('Opening the Hetzner console. Create/select a project, then Security → API Tokens →'));
     console.error(chalk.dim('Generate a token with Read & Write permission, and copy it.\n'));
-    openUrl(HETZNER_CONSOLE_URL);
+    await showUrl(HETZNER_CONSOLE_URL);
     const { password } = await import('@inquirer/prompts');
     const ora = (await import('ora')).default;
     try {
@@ -256,7 +256,8 @@ export function registerLeaseCommand(devicesCommand) {
         process.exit(ok ? 0 : 1);
     });
     lease
-        .command('gc')
+        .command('prune')
+        .alias('gc')
         .description('Stop expired, idle lease boxes that are holding your provider quota. Safe: never stops a box in active use.')
         .option('--dry-run', 'List reap-safe orphan boxes without stopping any', false)
         .option('--yes', 'Stop them without the interactive confirm', false)
@@ -269,7 +270,7 @@ export function registerLeaseCommand(devicesCommand) {
             candidates = reapSafeOrphans(crabboxList(boxOpts), nowSecs);
         }
         catch (e) {
-            console.error(chalk.red(`lease gc: ${e.message}`));
+            console.error(chalk.red(`lease prune: ${e.message}`));
             process.exit(1);
             return;
         }

package/dist/commands/mailboxes.js

@@ -405,17 +405,18 @@ export function registerMailboxesCommand(program) {
         renderOverview(boxes, limit, filters);
     });
     const gcCmd = cmd
-        .command('gc')
+        .command('prune')
+        .alias('gc')
         .description('Run a liveness sweep: archive pending messages in dead boxes and prune stale consumed mail.')
         .option('--json', 'Emit the GC result as JSON')
         .action(async (_opts, command) => runGcCommand({ json: command.optsWithGlobals().json === true }));
     setHelpSections(gcCmd, {
         examples: `
       # One-shot sweep using the live session set as the liveness source
-      agents mailboxes gc
+      agents mailboxes prune
 
       # Machine-readable summary (for scripts / monitors)
-      agents mailboxes gc --json
+      agents mailboxes prune --json
     `,
         notes: `
       A box is considered dead when no live session (the same source

package/dist/commands/menubar.js

@@ -115,7 +115,7 @@ export function registerMenubarCommands(program) {
         .description('Configure AGI Menu end-to-end: one instance, started at login')
         .option('--check', 'Report the current state, change nothing')
         .option('--json', 'Emit machine-readable JSON')
-        .action((options) => {
+        .action(async (options) => {
         if (options.check) {
             const s = getMenubarStatus();
             if (options.json) {
@@ -129,7 +129,7 @@ export function registerMenubarCommands(program) {
         }
         if (!options.json && notMac())
             return;
-        const r = runMenubarSetup();
+        const r = await runMenubarSetup();
         if (options.json) {
             process.stdout.write(JSON.stringify(r) + '\n');
         }
@@ -174,10 +174,17 @@ export function registerMenubarCommands(program) {
     menubar
         .command('enable')
         .description('Install and start AGI Menu (launches at login)')
-        .action(() => {
+        .action(async () => {
         if (notMac())
             return;
-        const ok = enableMenubarService({ clearOptOut: true });
+        let ok = false;
+        try {
+            ok = await enableMenubarService({ clearOptOut: true });
+        }
+        catch (e) {
+            console.log(chalk.red(`Could not enable AGI Menu: ${e.message}`));
+            return;
+        }
         if (!ok) {
             console.log(chalk.red('Could not enable: no AGI Menu bundle ships with this install.'));
             console.log(chalk.gray('  This build may predate the helper, or be a non-macOS package.'));

package/dist/commands/projects.d.ts

@@ -8,7 +8,7 @@
  * lifecycle state, plan completion, open PRs, and tickets in flight.
  */
 import type { Command } from 'commander';
-import { type ProjectRepo } from '../lib/projects.js';
+import { type ProjectDef, type ProjectRepo } from '../lib/projects.js';
 import { type LinearMilestone } from '../lib/linear-project-counts.js';
 /** Recursion guard: a peer answering a probe fan-out never re-fans-out itself. */
 export declare const PROJECTS_NO_FANOUT_ENV = "AGENTS_PROJECTS_LOCAL";
@@ -101,4 +101,19 @@ export declare function formatMilestoneDue(targetDate: string, nowMs: number): s
 export declare function formatMilestoneLines(milestones: LinearMilestone[], next: LinearMilestone | undefined, nowMs: number, limit: number): string[];
 /** The `next` card line: what this project is due to hit, and how far along it is. */
 export declare function formatNextMilestone(ms: LinearMilestone, nowMs: number): string;
+/** Options shared by `status` and `view`. */
+export type ProjectCardOpts = {
+    json?: boolean;
+    window?: string;
+    remote?: boolean;
+    /** Scope the fleet fan-out to specific devices; undefined = the whole fleet. */
+    deviceFilter?: string[];
+};
+/**
+ * Merge `--device a b` (variadic) and `--devices a,b,c` (comma list) into one
+ * deduped device filter; undefined when neither was given (= whole fleet).
+ */
+export declare function resolveDeviceFilter(device?: string[], devices?: string): string[] | undefined;
+/** Print the YAML-side fields that sit under the shared card in `view` mode. */
+export declare function printProjectDefinition(def: ProjectDef, name: string): void;
 export declare function registerProjectsCommands(program: Command): void;

package/dist/commands/projects.js

@@ -461,6 +461,44 @@ warnWorkspaces = []) {
     if (!detail)
         console.log('');
 }
+/**
+ * Merge `--device a b` (variadic) and `--devices a,b,c` (comma list) into one
+ * deduped device filter; undefined when neither was given (= whole fleet).
+ */
+export function resolveDeviceFilter(device, devices) {
+    const merged = [
+        ...(device ?? []),
+        ...(devices ? devices.split(',').map((s) => s.trim()).filter(Boolean) : []),
+    ];
+    return merged.length ? [...new Set(merged)] : undefined;
+}
+/** Print the YAML-side fields that sit under the shared card in `view` mode. */
+export function printProjectDefinition(def, name) {
+    console.log();
+    if (def.root)
+        console.log(`  ${chalk.dim('root')}     ${def.root}`);
+    if (def.defaultPath)
+        console.log(`  ${chalk.dim('path')}     ${def.defaultPath}`);
+    for (const rp of def.repos ?? []) {
+        const where = [rp.subpath ? `subpath ${rp.subpath}` : undefined, rp.path].filter(Boolean).join(' · ');
+        console.log(`  ${chalk.dim('repo')}     ${rp.slug}${where ? chalk.dim(`  (${where})`) : ''}`);
+    }
+    for (const g of def.goals ?? [])
+        console.log(`  ${chalk.dim('goal')}     ${g.objective}${g.measure ? chalk.dim(`  · ${g.measure}`) : ''}`);
+    for (const c of def.contexts ?? [])
+        console.log(`  ${chalk.dim('context')}  ${chalk.cyan(c.path)} ${chalk.dim('—')} ${c.purpose}`);
+    for (const ig of def.integrations ?? []) {
+        console.log(`  ${chalk.dim(ig.kind.padEnd(8))} ${ig.url}${ig.label ? chalk.dim(`  (${ig.label})`) : ''}`);
+    }
+    if (def.linear?.url || def.linear?.projectId || def.linear?.name) {
+        const ref = def.linear.url ?? def.linear.projectId;
+        const label = def.linear.name ? chalk.cyan(def.linear.name) : '';
+        console.log(`  ${chalk.dim('linear')}   ${[label, ref && chalk.dim(ref)].filter(Boolean).join('  ')}`);
+    }
+    for (const d of def.docs ?? [])
+        console.log(`  ${chalk.dim('doc')}      ${d}`);
+    console.log(chalk.gray(`  ${projectDefPath(name)}`));
+}
 export function registerProjectsCommands(program) {
     const projects = program
         .command('projects')
@@ -476,9 +514,9 @@ export function registerProjectsCommands(program) {
       agents projects list --with-agents   # opt-in local active counts
       agents projects list --json          # machine-readable defs (AGI EXT uses this)
       echo '{...}' | agents projects save --json  # create/update one def from stdin
-      agents projects rm rush --json       # machine-readable delete
+      agents projects remove rush --json   # machine-readable removal
       agents projects status              # every project, across the whole fleet
-      agents projects status rush         # one project (same body as view/show)
+      agents projects status rush         # one project (same body as view)
       agents projects view rush           # alias of status <name>
       agents projects status --device s0  # scope to one device (or --devices a,b,c)
       agents projects link rush --linear  # bind the Linear project (auto-suggest)
@@ -607,44 +645,6 @@ export function registerProjectsCommands(program) {
         for (const r of def.repos ?? [])
             console.log(chalk.gray(`  dir  ${r.path}  ·  ${r.slug}`));
     });
-    /** Merge `--device a b` (variadic) and `--devices a,b,c` (comma list) into one
-     *  deduped device filter; undefined when neither was given (= whole fleet). */
-    function resolveDeviceFilter(device, devices) {
-        const merged = [
-            ...(device ?? []),
-            ...(devices ? devices.split(',').map((s) => s.trim()).filter(Boolean) : []),
-        ];
-        return merged.length ? [...new Set(merged)] : undefined;
-    }
-    /** Print the YAML-side fields that sit under the shared card in `view` mode. */
-    function printProjectDefinition(def, name) {
-        console.log();
-        if (def.root)
-            console.log(`  ${chalk.dim('root')}     ${def.root}`);
-        if (def.defaultPath)
-            console.log(`  ${chalk.dim('path')}     ${def.defaultPath}`);
-        for (const rp of def.repos ?? []) {
-            const where = [rp.subpath ? `subpath ${rp.subpath}` : undefined, rp.path].filter(Boolean).join(' · ');
-            console.log(`  ${chalk.dim('repo')}     ${rp.slug}${where ? chalk.dim(`  (${where})`) : ''}`);
-        }
-        for (const g of def.goals ?? [])
-            console.log(`  ${chalk.dim('goal')}     ${g.objective}${g.measure ? chalk.dim(`  · ${g.measure}`) : ''}`);
-        for (const c of def.contexts ?? [])
-            console.log(`  ${chalk.dim('context')}  ${chalk.cyan(c.path)} ${chalk.dim('—')} ${c.purpose}`);
-        for (const ig of def.integrations ?? []) {
-            console.log(`  ${chalk.dim(ig.kind.padEnd(8))} ${ig.url}${ig.label ? chalk.dim(`  (${ig.label})`) : ''}`);
-        }
-        if (def.linear?.url || def.linear?.projectId || def.linear?.name) {
-            // Lead with the board's own name — the id/url answers "which project",
-            // but the name is what a reader (or an agent) calls the work.
-            const ref = def.linear.url ?? def.linear.projectId;
-            const label = def.linear.name ? chalk.cyan(def.linear.name) : '';
-            console.log(`  ${chalk.dim('linear')}   ${[label, ref && chalk.dim(ref)].filter(Boolean).join('  ')}`);
-        }
-        for (const d of def.docs ?? [])
-            console.log(`  ${chalk.dim('doc')}      ${d}`);
-        console.log(chalk.gray(`  ${projectDefPath(name)}`));
-    }
     async function runProjectCard(name, opts, mode) {
         const detail = mode === 'view';
         const all = listProjectDefs();
@@ -681,7 +681,7 @@ export function registerProjectsCommands(program) {
             const [probeRes, activeRes] = await Promise.all([
                 fleetTargets.length > 0
                     ? gatherRemoteAgentsJson({
-                        args: ['projects', 'probe', '--json', ...fleetTargets],
+                        args: ['projects', 'probe', ...fleetTargets],
                         noFanoutEnv: PROJECTS_NO_FANOUT_ENV,
                         hosts: opts.deviceFilter,
                         parse: parseRemoteProbe,
@@ -765,8 +765,7 @@ export function registerProjectsCommands(program) {
     projects
         .command('status [name]')
         .alias('view')
-        .alias('show')
-        .description('Progress card for every project across the whole fleet, or one named project (aliases: view, show). Named form also prints every milestone and the stored definition.')
+        .description('Progress card for every project across the whole fleet, or one named project (alias: view). Named form also prints every milestone and the stored definition.')
         .option('--json', 'Machine-readable output')
         .option('--window <days>', 'Window for merged PRs, artifacts, and focus areas', '7')
         .option('--no-remote', 'Skip the GitHub and Linear lookups; faster, offline')
@@ -774,8 +773,8 @@ export function registerProjectsCommands(program) {
         .option('--devices <names>', 'Scope fleet status to a comma-separated list of devices')
         .action(async (name, rawOpts) => {
         // Named invocation = `view` depth (all milestones + definition). Unnamed
-        // stays the scannable multi-project rollup. `view`/`show` are commander
-        // aliases of this same command, so there is only one implementation.
+        // stays the scannable multi-project rollup. `view` is a commander alias
+        // of this same command, so there is only one implementation.
         // Fleet is dialled by default; --device/--devices narrows it to a subset.
         const opts = {
             json: rawOpts.json,
@@ -806,7 +805,6 @@ export function registerProjectsCommands(program) {
     projects
         .command('probe [paths...]', { hidden: true })
         .description('Probe workspace repos (presence, branch, drift, dirtiness) and print JSON. Answers for this machine only.')
-        .option('--json', 'Machine-readable output (the only output format)')
         .action((paths) => {
         // Never fans out — the recursion guard env is set by the parent fan-out,
         // and this command has no remote code path either way.
@@ -817,7 +815,6 @@ export function registerProjectsCommands(program) {
         .command('pull-local', { hidden: true })
         .description('Fast-forward workspace repos (default-branch only) and print JSON. Answers for this machine only.')
         .requiredOption('--targets <json>', 'JSON array of {path, expectedSlug} targets, from the orchestrating `pull`')
-        .option('--json', 'Machine-readable output (the only output format)')
         .action(async (opts) => {
         // Never fans out — this is the peer half of the fleet fan-out.
         //
@@ -1158,9 +1155,9 @@ export function registerProjectsCommands(program) {
     });
     // ---- rm ----
     projects
-        .command('rm <name>')
-        .alias('remove')
-        .description('Delete a project definition. Never touches the repo.')
+        .command('remove <name>')
+        .alias('rm')
+        .description('Remove a project definition. Never touches the repo.')
         .option('--json', 'Machine-readable success / error')
         .action((name, opts) => {
         if (!isSafeProjectName(name)) {
@@ -1172,22 +1169,19 @@ export function registerProjectsCommands(program) {
             }
             process.exit(1);
         }
-        if (removeProjectDef(name)) {
-            if (opts.json) {
-                console.log(JSON.stringify({ ok: true, name, removed: true }));
-            }
-            else {
-                console.log(chalk.green(`Removed project "${name}"`));
-            }
+        const removed = removeProjectDef(name);
+        if (opts.json) {
+            console.log(JSON.stringify(removed
+                ? { ok: true, name, removed: true }
+                : { ok: false, name, error: `No project named "${name}"` }));
+        }
+        else if (removed) {
+            console.log(chalk.green(`Removed project "${name}"`));
         }
         else {
-            if (opts.json) {
-                console.log(JSON.stringify({ ok: false, name, error: `No project named "${name}"` }));
-            }
-            else {
-                console.error(chalk.red(`No project named "${name}".`));
-            }
-            process.exit(1);
+            console.error(chalk.red(`No project named "${name}".`));
         }
+        if (!removed)
+            process.exit(1);
     });
 }

package/dist/commands/resume.js

@@ -102,7 +102,7 @@ export async function runStrictResume(sessionId, prompt, options) {
         // one re-discovers locally and marks the run AGENTS_FLEET_REMOTE, which
         // a long-lived resumed session must not inherit.
         const { runOnPeer } = await import('../lib/session/remote-list.js');
-        const rc = await runOnPeer(buildResumeRemoteArgs(outcome.session.id, prompt, options), owner, { tty: !!process.stdout.isTTY, env: { [RESUME_PINNED_ENV]: '1' } });
+        const rc = await runOnPeer(buildResumeRemoteArgs(outcome.session.id, prompt, options), owner, { tty: !!process.stdout.isTTY, env: { [RESUME_PINNED_ENV]: '1' }, sessionId: outcome.session.id });
         if (rc === 'no-target') {
             console.error(chalk.red(`Session ${outcome.session.shortId} lives on ${owner}, which isn't a reachable device right now.`));
             console.error(chalk.gray(`Register/wake it (agents devices), or run there: agents ssh ${owner}`));

package/dist/commands/route.js

@@ -243,15 +243,15 @@ export function registerRouteCommands(program) {
         console.log(chalk.green(`Router '${name}': unlinked ${harness} account '${account}'`));
     });
     routeCmd
-        .command('rm <name>')
-        .alias('remove')
-        .description('Delete a router.')
+        .command('remove <name>')
+        .alias('rm')
+        .description('Remove a router.')
         .action((name) => {
         const source = routerSource(name);
         if (source === null)
             die(`Router '${name}' not found.`);
         if (source !== 'user') {
-            die(`Router '${name}' resolves from the '${source}' layer, not 'user' -- agents route rm can only remove a user-layer router.`);
+            die(`Router '${name}' resolves from the '${source}' layer, not 'user' -- agents route remove can only remove a user-layer router.`);
         }
         const existed = deleteRouter(name);
         if (!existed)

package/dist/commands/routines.js

@@ -904,7 +904,7 @@ export function registerRoutinesCommands(program) {
         .option('--workflow <name>', 'Run an installed workflow (~/.agents/workflows/<name>) via `agents run`. Mutually exclusive with --agent.')
         .option('--command <sh>', 'Run a plain shell command directly (no agent, no auth, no sandbox) — for deterministic housekeeping routines. Mutually exclusive with --agent and --workflow; --prompt is not used.')
         .option('-p, --prompt <prompt>', 'Task instruction for the agent')
-        .option('-m, --mode <mode>', "Execution mode: plan (read-only), edit (can write files), auto (smart classifier, the default), or skip (bypass all permission prompts). 'full' accepted as alias for skip.", 'auto')
+        .option('-m, --mode <mode>', "Execution mode: plan (read-only), edit (can write files), auto (the default; more autonomous than edit, mechanism per-harness — see `agents modes <agent>`), or skip (bypass all permission prompts). 'full' accepted as alias for skip.", 'auto')
         .option('-e, --effort <effort>', 'Reasoning effort: low | medium | high | xhigh | max | auto', 'auto')
         .option('-t, --timeout <timeout>', 'Kill the agent if it runs longer than this (e.g., 10m, 2h, 3d, 1w; max 1w)', '10m')
         .option('--timezone <tz>', 'Interpret schedule in this timezone (e.g., America/Los_Angeles)')
@@ -1281,7 +1281,8 @@ export function registerRoutinesCommands(program) {
         }
     });
     routinesCmd
-        .command('cleanup')
+        .command('prune')
+        .alias('cleanup')
         .description('Remove expired one-shot routines that already fired and still have a user-layer YAML file.')
         .option('--dry-run', 'Show routines that would be removed without deleting files')
         .action((options) => {
@@ -1297,7 +1298,7 @@ export function registerRoutinesCommands(program) {
             for (const job of jobs) {
                 console.log(`  ${chalk.cyan(job.name)} ${chalk.gray(scheduleLabel(job))}`);
             }
-            console.log(chalk.gray(`\nDry run. Remove with: agents routines cleanup`));
+            console.log(chalk.gray(`\nDry run. Remove with: agents routines prune`));
             return;
         }
         let removed = 0;

package/dist/commands/run-broadcast.d.ts

@@ -2,7 +2,7 @@
  * `agents run --broadcast` — run the same task/prompt across an agent × model
  * matrix (formerly `agents bench`).
  *
- * Task definitions live under apps/cli/bench/tasks/<id>/task.json.
+ * Task definitions live under cli/bench/tasks/<id>/task.json.
  */
 export interface BroadcastOpts {
     listTasks?: boolean;

package/dist/commands/run-broadcast.js

@@ -2,7 +2,7 @@
  * `agents run --broadcast` — run the same task/prompt across an agent × model
  * matrix (formerly `agents bench`).
  *
- * Task definitions live under apps/cli/bench/tasks/<id>/task.json.
+ * Task definitions live under cli/bench/tasks/<id>/task.json.
  */
 import * as fs from 'fs';
 import * as path from 'path';

package/dist/commands/sessions-picker-factory.d.ts

@@ -11,7 +11,8 @@ export interface SessionsPickerCommandSpec<TRow, TOpts extends SessionsPickerGat
      * selector) falls through to the flat printer. Computer has no `--open`.
      */
     requireOpenUndefined?: boolean;
-    runFlat: (opts: TOpts) => void;
+    /** May be async — the browser spec's flat path awaits an artifact open. */
+    runFlat: (opts: TOpts) => void | Promise<void>;
     buildRows: (opts: TOpts) => TRow[];
     emptyMessage: (opts: TOpts) => string;
     message: string;

package/dist/commands/sessions-picker-factory.js

@@ -44,7 +44,7 @@ export function createSessionsPickerCommand(spec) {
         shouldOpen,
         run: async (opts) => {
             if (!shouldOpen(opts, isInteractiveTerminal())) {
-                spec.runFlat(opts);
+                await spec.runFlat(opts);
                 return;
             }
             const rows = spec.buildRows(opts);

package/dist/commands/sessions-picker.d.ts

@@ -69,6 +69,26 @@ export declare function buildPreview(session: SessionMeta): string;
  * machine — far too much for a pane that repaints as the cursor moves. The line
  * names the command that does report them instead.
  */
+/**
+ * The "what did this session leave running" segments of the Doing line.
+ *
+ * Prefers a DERIVED count (fresh, from the transcript the caller just parsed)
+ * and falls back to the PERSISTED column, which is what lets a remote/unindexed
+ * row — rendered from `SessionMeta` alone, with no events — show fan-out at all.
+ * That fallback is the whole reason the counts are columns (RUSH-3091/3095).
+ *
+ * A count of 0 or undefined renders NOTHING. Both are real states — "scanned,
+ * none found" and "this harness cannot report it" — and a literal "0 background
+ * shells" would assert "nothing is running" for a harness that simply does not
+ * record them.
+ *
+ * Wording is "left behind", not "running": a transcript records a start and
+ * never a death (see extractBackgroundShells).
+ */
+export declare function formatFanOut(session: SessionMeta, derived?: {
+    subAgentCount?: number;
+    backgroundShellCount?: number;
+}): string[];
 export declare function formatTeamLineage(session: SessionMeta): string;
 /**
  * The three timing facts the header reports: when the session was created, when
@@ -94,6 +114,8 @@ export interface SessionPreviewDigest {
     planFile: string;
     todos?: TodoProgress;
     subAgentCount: number;
+    /** undefined when the harness records no background-shell concept. */
+    backgroundShellCount?: number;
     toolTags: string[];
     changes: ReturnType<typeof changeCounts>;
     dirs: string[];