@phnx-labs/agents-cli 1.20.78 → 1.20.82

package/dist/commands/events.js

@@ -76,7 +76,7 @@ export function registerEventsCommand(program) {
         .description('Read the unified event stream (operational + agent activity)')
         .option('--module <name>', 'Only events from this group (e.g. teams, secrets, activity)')
         .option('--command <path>', 'Only this command path — prefix match (e.g. "teams create")')
-        .option('--event <type>', 'Only this typed event (repeatable, e.g. secrets.get, pr.opened)', collect, [])
+        .option('--event <type>', 'Only this typed event (repeatable, e.g. secrets.get, secrets.unlocked, pr.opened)', collect, [])
         .option('--agent <name>', 'Only events tagged with this agent')
         .option('--since <time>', 'Only events newer than this (e.g. 2h, 7d, or ISO date)')
         .option('--audit', 'Operational events only (skip agent activity)')

package/dist/commands/exec.js

@@ -11,7 +11,7 @@ import { setHelpSections } from '../lib/help.js';
 import { isInteractiveTerminal, isPromptCancelled, requireInteractiveSelection } from './utils.js';
 import { getUserAgentsDir } from '../lib/state.js';
 import { parseLoopInterval } from '../lib/loop.js';
-import { AGENTS } from '../lib/agents.js';
+import { AGENTS, resolveAgentName, isAgentHardDeprecated, hardDeprecationError } from '../lib/agents.js';
 import { recordDispatchedRun } from '../lib/audit/log.js';
 import { maybeShowStarNudge } from '../lib/star-nudge.js';
 import { warnUnpushedWork, shouldWarnUnpushed } from '../lib/warn-unpushed.js';
@@ -372,10 +372,10 @@ export function registerRunCommand(program) {
         .option('--no-tmux', 'Spawn the agent directly instead of wrapping it in the shared tmux session. Same effect as --raw / AGENTS_NO_TMUX=1. Use this to see the agent\'s full startup output when a launch is failing.')
         .option('--disable-tmux', 'Alias for --no-tmux.')
         .option('--timeout <duration>', 'Kill the agent after this duration (e.g., 30m, 1h, 2h30m)')
-        .option('--fallback <agents>', 'Comma-separated agents to try on rate-limit failure. Each entry accepts an optional @version pin (e.g., codex@0.116.0,gemini). The primary runs first; if it exits with a rate-limit error, the next agent picks up via /continue handoff.')
+        .option('--fallback <agents>', 'Comma-separated agents to try on rate-limit failure. Each entry accepts an optional @version pin (e.g., codex@0.116.0,antigravity). The primary runs first; if it exits with a rate-limit error, the next agent picks up via /continue handoff.')
         .option('-b, --balanced', 'Shortcut for --strategy balanced. Ignored when @version is pinned.')
         .option('--strategy <strategy>', 'Version/account selection strategy: pinned | available | balanced. Defaults to run.<agent>.strategy, then balanced (spreads load across healthy accounts and skips any that are rate-limited). (Legacy `rotate` accepted as alias for `balanced`.)')
-        .option('--acp', 'Route through the Agent Client Protocol instead of direct exec. Supported for gemini, claude (via @zed-industries/claude-code-acp adapter). Unified event stream; emits ndjson when --json.')
+        .option('--acp', 'Route through the Agent Client Protocol instead of direct exec. Supported for claude via @zed-industries/claude-code-acp adapter. Unified event stream; emits ndjson when --json.')
         .option('-y, --yes', 'Skip the interactive budget-confirm prompt (require_confirm_over). Never skips a hard budget block.', false)
         .option('--loop', 'Re-inject the prompt/entrypoint each iteration until a stop condition (issue #332). Guards (--max-iterations, --budget, --until) are enforced outside the agent. Writes a checkpoint after every iteration for --resume-checkpoint.')
         .option('--resume-checkpoint <file>', 'Resume a killed loop run from its checkpoint.json. Continues from the last completed iteration, reusing the same runId, session id, prompt, and loop config.')
@@ -464,7 +464,7 @@ export function registerRunCommand(program) {
         installed account for this run. Rows show identity, login state, plan,
         and available limits; unsafe accounts stay visible but disabled.
 
-      Fallback: --fallback codex,gemini retries on rate-limit failure via /continue handoff. Each entry accepts @version.
+      Fallback: --fallback codex,antigravity retries on rate-limit failure via /continue handoff. Each entry accepts @version.
 
       Resume: --resume <id> continues a prior conversation (full or partial id; omit to pick interactively). claude/codex resume natively; others replay via a /continue first message. Add a prompt to continue headlessly.
 
@@ -502,6 +502,12 @@ export function registerRunCommand(program) {
             console.error(chalk.red(`Invalid account picker target: ${agentSpec}. Use agents run <agent>@.`));
             process.exit(1);
         }
+        // Hard-deprecated harnesses cannot be run — point the user at the successor.
+        const runBaseAgentId = resolveAgentName(normalizedAgentSpec.split('@')[0]);
+        if (runBaseAgentId && isAgentHardDeprecated(runBaseAgentId)) {
+            console.error(chalk.red(hardDeprecationError(runBaseAgentId)));
+            process.exit(1);
+        }
         // Account-picker conflict check runs BEFORE device=auto may set balanced,
         // so an implicit balanced preference never surfaces as a fake
         // "cannot be combined with --balanced" when the user only typed trailing @.
@@ -965,8 +971,19 @@ export function registerRunCommand(program) {
                 // Working directory on the host: an explicit --remote-cwd is used
                 // verbatim; --cwd/--project are made portable (a local-home absolute
                 // becomes `~/…` so the remote shell re-roots it at ITS home).
+                //
+                // With neither flag, mirror the LOCAL cwd's home-relative path onto
+                // the host (deriveMirroredCwd). Otherwise every host run starts in the
+                // remote `$HOME` — launch an agent from a repo and it opens with no
+                // project, and you `cd` by hand every time. The same checkout at the
+                // same home-relative path on both boxes is the normal fleet layout, so
+                // the mirror usually hits; when the host lacks that directory the run
+                // falls back to the remote home rather than failing.
                 const { toRemotePortable } = await import('../lib/project-root.js');
-                const hostCwd = options.remoteCwd ?? (options.cwd ? toRemotePortable(options.cwd) : undefined);
+                const { deriveMirroredCwd } = await import('../lib/hosts/dispatch.js');
+                const explicitHostCwd = options.remoteCwd ?? (options.cwd ? toRemotePortable(options.cwd) : undefined);
+                const hostCwd = explicitHostCwd ?? deriveMirroredCwd(process.cwd());
+                const mirrorHostCwd = explicitHostCwd === undefined;
                 const hostAddDirs = options.addDir.length > 0 ? options.addDir.map(toRemotePortable) : undefined;
                 // `--resume [id]`: commander yields the string id, or `true` when the
                 // flag is passed bare. A bare resume needs the interactive picker,
@@ -1104,6 +1121,7 @@ export function registerRunCommand(program) {
                         yes: options.yes,
                         acp: options.acp,
                         remoteCwd: hostCwd,
+                        mirrorCwd: mirrorHostCwd,
                         sessionId: hostSessionId,
                         name: options.name,
                         resume: resumeId,
@@ -1190,6 +1208,7 @@ export function registerRunCommand(program) {
                     acp: options.acp,
                     autoSecrets: options.autoSecrets,
                     remoteCwd: hostCwd,
+                    mirrorCwd: mirrorHostCwd,
                     name: options.name,
                     resume: resumeId,
                     sessionId: options.sessionId,

package/dist/commands/feed.d.ts

@@ -59,3 +59,7 @@ export declare function sessionHintsFromActive(sessions: Array<{
     };
 }>): SessionOutcomeHint[];
 export declare function registerFeedCommand(program: Command): void;
+/** Feed view selector (RUSH-2015): decisions, progress, or both. */
+export type FeedFilter = 'needs' | 'updates' | 'all';
+/** Normalize a raw --filter value; unknown/empty falls back to the default. */
+export declare function resolveFeedFilter(raw: string | undefined): FeedFilter;

package/dist/commands/feed.js

@@ -1,6 +1,6 @@
 import chalk from 'chalk';
 import { ensureFeedPublishHook, listAskStats, listBlocks, recordNotified } from '../lib/feed.js';
-import { ensureActivityLogHook, readRecentActivity, formatActivityLine } from '../lib/activity.js';
+import { ensureActivityLogHook, readRecentActivity, formatActivityLine, formatProgressUpdate } from '../lib/activity.js';
 import { postFeedStatus } from '../lib/feed-post.js';
 import { enrichBlocksFromSessions, groupBlocksByOutcome, isUnambiguousOutcomeAnswer, openBlocksForOutcome, stampBlockOutcomes, } from '../lib/feed-outcome.js';
 import { classifyBlock, filterBlocksForFeed, suppressionDigest, } from '../lib/ask-classifier.js';
@@ -219,6 +219,7 @@ export function registerFeedCommand(program) {
         .command('feed')
         .description('Open blocks (needs you) + agent status posts (feed post)')
         .option('--json', 'Output as JSON (each block stamped with its outcome + ask class)')
+        .option('--filter <view>', 'What to show: needs (default) · updates · all', 'needs')
         .option('--flat', 'List one block per agent instead of grouping by outcome')
         .option('--all', 'Include stalls/FYIs that policy would suppress (default: hide them)')
         .option('--local', 'Only this machine -- skip the cross-machine SSH fan-out')
@@ -232,11 +233,13 @@ export function registerFeedCommand(program) {
         .description('Post a status update to the fleet activity stream (for agents)')
         .argument('<text...>', 'What just happened — one short human line')
         .option('--session <id>', 'Session id escape hatch (default: auto from env / pid registry)')
+        .option('--attach <path-or-url...>', 'Attach an artifact (local file or URL); repeatable')
         .option('--json', 'Emit the written event as JSON')
         .addHelpText('after', `
 Examples:
   # Inside an agents-cli run (session identity is already in the env):
   agents feed post "CHANGELOG pushed; watching CI and mac-mini E2E"
+  agents feed post "cover render ready" --attach ./out/cover.png
   agents feed post "ready for review" --json
 
   # Outside a run, pass the session explicitly:
@@ -251,18 +254,20 @@ Domain facts (tickets, PRs) are not CLI flags — join them on the session at re
         // parent.opts().json — not the child. Read both.
         const flags = {
             session: opts?.session ?? cmd?.opts?.()?.session,
+            attach: opts?.attach ?? cmd?.opts?.()?.attach,
             json: Boolean(opts?.json ?? cmd?.opts?.()?.json ?? cmd?.parent?.opts?.()?.json),
         };
         try {
             const { event } = postFeedStatus({
                 text: Array.isArray(textParts) ? textParts.join(' ') : String(textParts ?? ''),
                 sessionId: flags.session,
+                attach: flags.attach,
             });
             if (flags.json) {
                 console.log(JSON.stringify(event, null, 2));
                 return;
             }
-            console.log(formatActivityLine(event, { showHost: true }).trimStart());
+            console.log(formatProgressUpdate(event));
         }
         catch (err) {
             console.error(chalk.red(err.message));
@@ -273,6 +278,7 @@ Domain facts (tickets, PRs) are not CLI flags — join them on the session at re
         if (opts.device?.length)
             opts.host = [...(opts.host ?? []), ...opts.device];
         const self = machineId();
+        const filter = resolveFeedFilter(opts.filter);
         const includeLocal = shouldIncludeLocalFeed(opts.host, self);
         const setupWarnings = [];
         if (includeLocal) {
@@ -299,6 +305,22 @@ Domain facts (tickets, PRs) are not CLI flags — join them on the session at re
                 }
             }
         }
+        // Updates view: deliberate progress posts only, over the local activity
+        // timeline (blocks are decisions, not announcements). Short-circuit the
+        // whole block pipeline — no remote fan-out, no dispatch policy.
+        if (filter === 'updates') {
+            for (const warning of setupWarnings) {
+                console.error(chalk.yellow(`Feed hook setup warning: ${warning}`));
+            }
+            if (opts.json) {
+                const updates = readRecentActivity({ sinceMs: Date.now() - 7 * 24 * 60 * 60 * 1000, limit: 100 })
+                    .filter((e) => e.event === 'status.posted');
+                console.log(JSON.stringify(updates, null, 2));
+                return;
+            }
+            renderUpdatesView();
+            return;
+        }
         // Active sessions feed both the GC sweep and outcome enrichment (ticket/PR).
         let sessions = [];
         if (includeLocal) {
@@ -406,8 +428,14 @@ Domain facts (tickets, PRs) are not CLI flags — join them on the session at re
         }
         if (blocks.length === 0) {
             console.log(chalk.gray(digest ? 'No open blocks after stall suppression.' : 'No open blocks.'));
-            if (includeLocal)
-                renderActivityLane();
+            if (includeLocal) {
+                if (filter === 'all') {
+                    console.log();
+                    renderUpdatesView();
+                }
+                else
+                    renderActivityLane();
+            }
             return;
         }
         // Shared fleet-comms masthead (same family as `agents mailboxes`).
@@ -430,22 +458,70 @@ Domain facts (tickets, PRs) are not CLI flags — join them on the session at re
         });
         for (const g of groups)
             renderOutcomeGroup(g, self);
-        if (includeLocal)
-            renderActivityLane();
+        if (includeLocal) {
+            if (filter === 'all') {
+                console.log();
+                renderUpdatesView();
+            }
+            else
+                renderActivityLane();
+        }
     });
 }
+/** Normalize a raw --filter value; unknown/empty falls back to the default. */
+export function resolveFeedFilter(raw) {
+    const v = (raw ?? '').trim().toLowerCase();
+    if (v === 'updates' || v === 'update')
+        return 'updates';
+    if (v === 'all')
+        return 'all';
+    return 'needs';
+}
+/**
+ * Render one activity event in the lane: deliberate progress posts
+ * (`status.posted`) use the rich multi-line {@link formatProgressUpdate}; hook
+ * milestones (PR, commit, …) keep the compact {@link formatActivityLine}.
+ */
+function renderActivityEntry(ev) {
+    if (ev.event === 'status.posted') {
+        console.log(formatProgressUpdate(ev));
+    }
+    else {
+        console.log(formatActivityLine(ev, { showHost: true }));
+    }
+}
+/**
+ * Render the **Updates** view: deliberate progress posts only (`status.posted`),
+ * recency-ordered, with rich identity chips. Pure `file.edited` / git-hook noise
+ * is excluded so operators see announcements, not tool churn.
+ */
+function renderUpdatesView(limit = 30) {
+    const updates = readRecentActivity({ sinceMs: Date.now() - 7 * 24 * 60 * 60 * 1000, limit })
+        .filter((e) => e.event === 'status.posted');
+    console.log(masthead({ title: 'updates', accent: 'cyan', host: machineId(), right: `${updates.length} post${updates.length === 1 ? '' : 's'}` }));
+    console.log();
+    if (updates.length === 0) {
+        console.log(chalk.gray('  No progress updates yet. Agents post them with `agents feed post "…"`.'));
+        return;
+    }
+    for (const ev of updates) {
+        console.log(formatProgressUpdate(ev));
+        console.log();
+    }
+}
 /**
  * Print a compact "recent activity" lane under the feed: the last few milestone
- * events (plans, PRs, worktrees, sub-agents) from the append-only activity logs.
- * Read-only tail of the logs -- no transcript re-parsing. Silent when empty.
+ * events (plans, PRs, worktrees, sub-agents, progress posts) from the append-only
+ * activity logs. Read-only tail of the logs -- no transcript re-parsing. Silent
+ * when empty.
  */
-function renderActivityLane() {
-    const events = readRecentActivity({ sinceMs: Date.now() - 24 * 60 * 60 * 1000, limit: 6 })
+function renderActivityLane(limit = 6) {
+    const events = readRecentActivity({ sinceMs: Date.now() - 24 * 60 * 60 * 1000, limit })
         .filter((e) => e.tier === 'milestone');
     if (events.length === 0)
         return;
     console.log(chalk.bold('\n  recent activity'));
     for (const ev of events)
-        console.log(formatActivityLine(ev, { showHost: true }));
+        renderActivityEntry(ev);
     console.log(chalk.gray('  → agents activity  for the full stream'));
 }

package/dist/commands/harness.js

@@ -26,7 +26,7 @@ export function registerHarnessCommands(program) {
         .alias('harnesses')
         .description('Custom harnesses — name a (host CLI + model) combo and run it like a native agent type.')
         .addHelpText('after', `
-A custom harness pins a host CLI (opencode, claude, codex, grok, gemini, ...) to a
+A custom harness pins a host CLI (opencode, claude, codex, grok, antigravity, ...) to a
 model and gives it a name. 'agents run <name>' then behaves like a native agent
 type, and 'agents repo push user' syncs it to every device.
 
@@ -49,7 +49,7 @@ Examples:
     cmd
         .command('add <name>')
         .description('Create a custom harness from a host + model (or apply a built-in preset).')
-        .option('--host <agent>', 'Host CLI to run under (opencode, claude, codex, grok, gemini, ...) — pair with --model')
+        .option('--host <agent>', 'Host CLI to run under (opencode, claude, codex, grok, antigravity, ...) — pair with --model')
         .option('--model <id>', 'Model id to pin on the host (e.g., meta/muse-spark-1.1) — pair with --host')
         .option('--base-url <url>', 'Custom endpoint base URL (claude/codex hosts)')
         .option('--auth-provider <provider>', 'Attach a keychain-backed API key under this provider (for private endpoints)')

package/dist/commands/hooks.js

@@ -221,7 +221,7 @@ When to use:
     hooksCmd
         .command('add [source]')
         .description('Install hooks from a source (GitHub, local) or pick from central storage')
-        .option('-a, --agents <list>', 'Targets: claude, codex@0.116.0, or gemini@default')
+        .option('-a, --agents <list>', 'Targets: claude, codex@0.116.0, or antigravity@default')
         .option('--names <list>', 'Hook names from ~/.agents/hooks/ (comma-separated)')
         .option('-y, --yes', 'Skip all prompts')
         .addHelpText('after', `

package/dist/commands/import.js

@@ -29,8 +29,8 @@ import * as fs from 'fs';
 import * as os from 'os';
 import * as path from 'path';
 import { confirm } from '@inquirer/prompts';
-import { ALL_AGENT_IDS } from '../lib/agents.js';
-import { AGENTS, getCliPath, getCliVersion, agentLabel, resolveAgentName } from '../lib/agents.js';
+import { MANAGED_AGENT_IDS } from '../lib/agents.js';
+import { AGENTS, getCliPath, getCliVersion, agentLabel, resolveAgentName, isAgentHardDeprecated, hardDeprecationError } from '../lib/agents.js';
 import { getVersionDir } from '../lib/versions.js';
 import { finalizeImport, importAgentBinary, importAgentConfig, importInstallScriptBinary, seedIsolatedConfigFromLocal, isValidImportVersion, resolvePackageDirFromBinary, } from '../lib/import.js';
 import { isPromptCancelled, isInteractiveTerminal } from './utils.js';
@@ -38,7 +38,11 @@ async function runImport(agentArg, opts) {
     const agentId = resolveAgentName(agentArg);
     if (!agentId) {
         console.error(chalk.red(`Unknown agent: ${agentArg}`));
-        console.error(chalk.gray(`Known agents: ${ALL_AGENT_IDS.join(', ')}`));
+        console.error(chalk.gray(`Known agents: ${MANAGED_AGENT_IDS.join(', ')}`));
+        process.exit(1);
+    }
+    if (isAgentHardDeprecated(agentId)) {
+        console.error(chalk.red(hardDeprecationError(agentId)));
         process.exit(1);
     }
     const agent = AGENTS[agentId];
@@ -340,7 +344,7 @@ When to use:
   under agents-cli management without reinstalling. Creates a symlink farm
   pointing at the existing install — nothing is copied or moved (except the
   agent's config dir, which is moved into the version's home). Works for both
-  npm-style packages (claude, codex, gemini, opencode, openclaw) and
+  npm-style packages (claude, codex, opencode, openclaw) and
   installScript-based agents (grok, antigravity, cursor, kiro, goose).
 `)
         .action((...args) => withIsolationBoundary(() => runImport(...args)));

package/dist/commands/logs.js

@@ -358,6 +358,12 @@ async function runStats(opts) {
             console.log(`    ${k.padEnd(30)} ${v}`);
         }
     }
+    if (Object.keys(s.byActor).length) {
+        console.log(chalk.bold('\n  By actor:'));
+        for (const [k, v] of Object.entries(s.byActor).sort((a, b) => b[1] - a[1])) {
+            console.log(`    ${k.padEnd(30)} ${v}`);
+        }
+    }
     console.log();
 }
 /** Register the top-level `agents logs` command. */

package/dist/commands/models.js

@@ -13,7 +13,7 @@ import { listInstalledVersions, getGlobalDefault, resolveVersion, resolveVersion
 import { getModelCatalog, locateModelSource } from '../lib/models.js';
 import { terminalWidth, truncateToWidth, stringWidth } from '../lib/session/width.js';
 import { wrapJoined } from './inspect.js';
-const MODEL_CAPABLE_AGENTS = ['claude', 'codex', 'gemini', 'opencode', 'cursor', 'openclaw', 'antigravity', 'kimi'];
+const MODEL_CAPABLE_AGENTS = ['claude', 'codex', 'opencode', 'cursor', 'openclaw', 'antigravity', 'kimi'];
 /**
  * Agents that don't necessarily install under ~/.agents/versions (cursor ships
  * via a curl script). For these, fall back to the PATH binary and synthesize

package/dist/commands/packages.js

@@ -10,7 +10,7 @@ import * as path from 'path';
 import chalk from 'chalk';
 import ora from 'ora';
 import { getAgentsDir, getEnabledExtraRepos } from '../lib/state.js';
-import { AGENTS, ALL_AGENT_IDS, getAllCliStates, agentLabel, } from '../lib/agents.js';
+import { AGENTS, getAllCliStates, agentLabel, } from '../lib/agents.js';
 import { capableAgents } from '../lib/capabilities.js';
 import { DEFAULT_REGISTRIES } from '../lib/types.js';
 import { getRegistries, setRegistry, removeRegistry, search as searchRegistries, resolvePackage, validatedNpmSpec, validatedPyPISpec, buildSkillIndex, verifySkillIntegrity, parseOwnerRepoFromRemote, } from '../lib/registry.js';
@@ -419,7 +419,7 @@ the sha256 in the index and abort on mismatch.
         console.log(chalk.gray('\n  Register + search + install:'));
         console.log(`    ${chalk.green(`agents registry add skill ${registryName} ${rawUrl}`)}`);
         console.log(`    ${chalk.green(`agents search ${index.skills[0].name} --type skill`)}`);
-        console.log(`    ${chalk.green(`agents install skill:${index.skills[0].name} --agents claude,codex,gemini`)}`);
+        console.log(`    ${chalk.green(`agents install skill:${index.skills[0].name} --agents claude,codex,cursor`)}`);
     });
     // ==========================================================================
     // INSTALL COMMAND (unified package installation)
@@ -427,7 +427,7 @@ the sha256 in the index and abort on mismatch.
     program
         .command('install <identifier>')
         .description('Install a package by registry name (mcp:notion), GitHub URL (gh:user/repo), or skill identifier')
-        .option('-a, --agents <list>', 'Targets: claude, codex@0.116.0, or gemini@default')
+        .option('-a, --agents <list>', 'Targets: claude, codex@0.116.0, or cursor@default')
         .option('--types <list>', 'When source is a repo: comma-separated resource types to install (skills,workflows,commands,hooks,permissions,subagents,mcp)')
         .option('--names <list>', 'When source is a repo: comma-separated resource names within the selected types')
         .option('-y, --yes', 'Auto-install any missing agent versions without prompting')
@@ -624,10 +624,10 @@ When to use:
                     console.log(`  ${count} ${kind}`);
                 }
                 const gitCliStates = await getAllCliStates();
-                const installedAgents = ALL_AGENT_IDS.filter((id) => gitCliStates[id]?.installed || listInstalledVersions(id).length > 0);
+                const installedAgents = capableAgents('commands').filter((id) => gitCliStates[id]?.installed || listInstalledVersions(id).length > 0);
                 let targets;
                 if (options.agents) {
-                    const resolved = await resolveInstalledAgentTargetsAutoInstalling(options.agents, ALL_AGENT_IDS, { yes: options.yes });
+                    const resolved = await resolveInstalledAgentTargetsAutoInstalling(options.agents, capableAgents('commands'), { yes: options.yes });
                     if (!resolved) {
                         console.log(chalk.gray('Cancelled.'));
                         return;
@@ -635,7 +635,7 @@ When to use:
                     targets = resolved;
                 }
                 else {
-                    targets = resolveConfiguredAgentTargets(installedAgents, undefined, ALL_AGENT_IDS);
+                    targets = resolveConfiguredAgentTargets(installedAgents, undefined, capableAgents('commands'));
                 }
                 if (targets.selectedAgents.length === 0) {
                     console.log(chalk.yellow('\nNo agents selected.'));

package/dist/commands/permissions.js

@@ -208,7 +208,7 @@ When to use:
     permissionsCmd
         .command('add [source]')
         .description('Import permissions from an agent config, YAML, or GitHub, then apply to versions')
-        .option('-a, --agents <list>', 'Targets: claude, codex@0.116.0, or gemini@default')
+        .option('-a, --agents <list>', 'Targets: claude, codex@0.116.0, or antigravity@default')
         .option('--names <list>', 'Permission set names from ~/.agents/permissions/ (comma-separated)')
         .option('--all', 'Apply to all installed versions instead of just defaults')
         .option('--replace', 'Replace managed permission block instead of merging (drops rules no longer in the set)')

package/dist/commands/profiles.js

@@ -272,7 +272,7 @@ export function registerProfilesCommands(program) {
         .command('profiles')
         .description('Named bundles of (host CLI, endpoint, model, auth) — run Kimi/DeepSeek/Qwen/etc through Claude Code without a proxy.')
         .addHelpText('after', `
-A profile pins a host CLI (claude, codex, gemini, ...) to a non-default endpoint
+A profile pins a host CLI (claude, codex, antigravity, ...) to a non-default endpoint
 and model, with a keychain-backed API key. Running 'agents run <profile>' spawns
 the host CLI with the right env vars — no plaintext tokens, no local proxy.
 

package/dist/commands/pull.d.ts

@@ -6,7 +6,7 @@
  * etc.). It is replaced by the explicit split:
  *
  *   - `agents repo pull <alias>`     — git fetch+ff on system / user / extra
- *   - `agents repo refresh [agent]`  — re-materialize installed version homes
+ *   - `agents sync [--local] [agent]` — re-materialize installed version homes
  *   - `agents setup`                 — first-time bootstrap
  *
  * The command is kept registered so old muscle-memory invocations get a clear

package/dist/commands/pull.js

@@ -6,7 +6,7 @@
  * etc.). It is replaced by the explicit split:
  *
  *   - `agents repo pull <alias>`     — git fetch+ff on system / user / extra
- *   - `agents repo refresh [agent]`  — re-materialize installed version homes
+ *   - `agents sync [--local] [agent]` — re-materialize installed version homes
  *   - `agents setup`                 — first-time bootstrap
  *
  * The command is kept registered so old muscle-memory invocations get a clear
@@ -15,20 +15,20 @@
 import { setHelpSections } from '../lib/help.js';
 const REDIRECT = 'agents-cli: "agents pull" was removed.\n' +
     '            Git pull a repo:   agents repo pull <alias>      (system | user | <extra>)\n' +
-    '            Re-materialize:    agents repo refresh [agent]   (claude | codex | ...)\n' +
+    '            Re-materialize:    agents sync --local           (all agents; or: agents sync <agent>)\n' +
     '            First-time setup:  agents setup\n\n';
 /** Register the deprecated `agents pull` command as a hard-error redirect. */
 export function registerPullCommand(program) {
     const pullCmd = program
         .command('pull [agent]')
-        .description('Removed. See `agents repo pull` + `agents repo refresh`.')
+        .description('Removed. See `agents repo pull` + `agents sync`.')
         .option('-y, --yes', '(no-op)')
         .option('--skip-clis', '(no-op)');
     setHelpSections(pullCmd, {
         notes: `
       Removed. Equivalents:
         agents repo pull <alias>     git pull (system | user | extra)
-        agents repo refresh [agent]  re-materialize version homes
+        agents sync --local          re-materialize version homes (or: agents sync <agent>)
         agents setup                 first-time bootstrap
     `,
     });

package/dist/commands/repo.d.ts

@@ -69,10 +69,88 @@ export declare function formatResourceDelta(entries: {
     action: ChangeAction;
     file: string;
 }[], maxParts?: number): string;
+/** One side of a divergence: the resource delta plus the raw commit count (fallback). */
+interface RepoDivergence {
+    delta: ResourceDelta;
+    commits: number;
+}
+/**
+ * Structured status for one repo. `raw` is a free-form trailer for special cases
+ * (missing repo, no git remote, error) that don't fit the columns; otherwise the
+ * fields feed whichever layout (table / cards) the terminal width selects.
+ */
+export interface RepoRow {
+    alias: string;
+    raw?: string;
+    branch?: string;
+    tracking?: boolean;
+    pull?: RepoDivergence;
+    push?: RepoDivergence;
+    clean?: boolean;
+    local?: ResourceDelta;
+    url?: string;
+    commit?: string;
+}
 /** `owner/repo` from a git URL, for the compact card header. Falls back to the raw URL. */
 export declare function repoSlug(url: string): string;
 /** Pack colored phrases into `, `-joined lines no wider than `width`. */
 export declare function wrapPhrases(parts: string[], width: number): string[];
+/** Options shared by `agents repo list` and the `agents repo status` alias. */
+export interface RepoStatusOptions {
+    verbose?: boolean;
+    json?: boolean;
+    /** Fan out across every reachable fleet device (`--devices-all`/`--hosts-all`). */
+    devicesAll?: boolean;
+    hostsAll?: boolean;
+    /** `all`, or a comma-separated device list (`--devices`/`--hosts`). */
+    devices?: string;
+    hosts?: string;
+}
+/**
+ * Per-device repo status — the unit of the `--devices-all` fleet fan-out. One
+ * entry per device: its parsed repo rows when reachable, or `reachable: false`
+ * when the peer could not be queried (kept in the model so the table can mark it).
+ */
+export interface DeviceRepoStatus {
+    device: string;
+    reachable: boolean;
+    rows?: RepoRow[];
+}
+/**
+ * Recursion guard for the fleet fan-out, passed as an env var (not a CLI flag)
+ * so an OLDER remote `agents` that predates this feature ignores it harmlessly
+ * instead of erroring on an unknown option. A peer new enough to fan out reads
+ * it and answers only for itself. Mirrors `NO_FANOUT_ENV` in remote-active.ts.
+ */
+export declare const NO_REPO_FANOUT_ENV = "AGENTS_REPO_LOCAL";
+/**
+ * Parse one peer's `repo status --json` stdout (a RepoRow[]) into a single
+ * device entry tagged with `machine`. Defensive against version skew: non-JSON
+ * or a non-array yields no entry, and non-object rows are dropped rather than
+ * throwing. Exported for unit testing without a live tailnet.
+ */
+export declare function parseRemoteRepoRows(stdout: string, machine: string): DeviceRepoStatus[];
+/**
+ * Render the fleet repo-status table: one row per (device, repo), with the
+ * device name shown once per group. SYNC and CHANGES reuse the same compact
+ * cells as the local wide table (`↓N (…)  ↑N` / `clean` / `~N edits`), and an
+ * unreachable device collapses to a single `unreachable` marker row. Pure — no
+ * I/O — so the aggregation/formatting is unit-testable without live devices.
+ */
+export declare function renderDeviceStatusRows(results: DeviceRepoStatus[]): string[];
+/** Where a `repo status` run should report: this machine only, or the fleet. */
+type DeviceIntent = {
+    all: true;
+} | {
+    hosts: string[];
+};
+/**
+ * Read the device-scope flags into an intent, or null for the default local-only
+ * run. `--devices-all`/`--hosts-all` (and `--devices all`/`--hosts all`) sweep
+ * every reachable peer; `--devices box1,box2` targets an explicit list. A peer
+ * carrying {@link NO_REPO_FANOUT_ENV} never fans out again (recursion guard).
+ */
+export declare function resolveDeviceIntent(opts: RepoStatusOptions): DeviceIntent | null;
 /** Register the `agents repos` command tree (`repo` is a convenience alias). */
 export declare function registerRepoCommands(program: Command): void;
 export {};