@phnx-labs/agents-cli 1.22.113 → 1.22.115

package/dist/commands/mcp.js

@@ -5,14 +5,14 @@ import ora from 'ora';
 import { checkbox } from '@inquirer/prompts';
 import { capableAgents, isCapable } from '../lib/capabilities.js';
 import { emit } from '../lib/feed/events.js';
-import { AGENTS, getAllCliStates, resolveAgentName, formatAgentError, registerMcpToTargets, unregisterMcpFromTargets, listInstalledMcpsWithScope, parseMcpConfig, getMcpConfigPathForHome, agentLabel, } from '../lib/agents.js';
+import { AGENTS, getAllCliStates, resolveAgentName, formatAgentError, unregisterMcpFromTargets, listInstalledMcpsWithScope, parseMcpConfig, getMcpConfigPathForHome, agentLabel, } from '../lib/agents.js';
 import { readManifest, writeManifest, createDefaultManifest } from '../lib/manifest.js';
 import { listMcpServerConfigs, discoverMcpConfigsFromRepo, installMcpConfigCentrally, isProjectMcpTrusted, trustProjectMcp, untrustProjectMcp, getMcpTrustStorePath, } from '../lib/mcp.js';
 import { cloneRepo } from '../lib/git.js';
 import { getMcpDir, getProjectAgentsDir } from '../lib/state.js';
-import { getEffectiveHome, getGlobalDefault, listInstalledVersions, getVersionHomePath, resolveInstalledAgentTargets, resolveConfiguredAgentTargets, syncResourcesToVersion, } from '../lib/installations/versions.js';
+import { getEffectiveHome, getGlobalDefault, listInstalledVersions, getVersionHomePath, resolveInstalledAgentTargets, syncResourcesToVersion, } from '../lib/installations/versions.js';
 import { getUserAgentsDir } from '../lib/state.js';
-import { isPromptCancelled, isInteractiveTerminal, requireInteractiveSelection, promptRemovalTargets, parseCommaSeparatedList, ensureAgentVersionsInstalled, resolveAgentTargetsAutoInstalling, resolveInstalledAgentTargetsAutoInstalling, VersionNotInstalledError, resolveListFilterOrExit, } from './utils.js';
+import { isPromptCancelled, isInteractiveTerminal, requireInteractiveSelection, promptRemovalTargets, parseCommaSeparatedList, ensureAgentVersionsInstalled, resolveAgentTargetsAutoInstalling, VersionNotInstalledError, resolveListFilterOrExit, } from './utils.js';
 import { showResourceList, buildTargetsSection, } from './resource-view.js';
 /**
  * Parse a comma-separated --agents string into validated agent IDs and
@@ -137,12 +137,12 @@ Examples:
   agents mcp add my-api https://api.example.com --transport http --agents claude
 
   # Apply servers from manifest to specific agents
-  agents mcp register --agents codex@0.116.0
+  agents sync --mcp codex@0.116.0
 
 When to use:
   - After install: 'agents mcp add <server>' to connect a new service
-  - Version upgrade: 'agents mcp register' to sync servers to the new version
-  - Team setup: commit mcp config to .agents and run 'agents mcp register'
+  - Version upgrade: 'agents sync --mcp' to sync servers to the new version
+  - Team setup: commit mcp config to .agents and run 'agents sync --mcp'
 `);
     withAliases(mcpCmd
         .command('list [agent]'), 'list')
@@ -220,7 +220,7 @@ When to use:
     });
     mcpCmd
         .command('add <name> [command_or_url...]')
-        .description('Add an MCP server to the manifest (run "agents mcp register" afterward to apply)')
+        .description('Add an MCP server to the manifest (run "agents sync --mcp" afterward to apply)')
         .option('-a, --agents <list>', 'Targets: claude, codex@0.116.0', capableAgents('mcp').join(','))
         .option('-s, --scope <scope>', 'user (global) or project (repo-specific)', 'user')
         .option('-t, --transport <type>', 'stdio (default) or http', 'stdio')
@@ -336,7 +336,7 @@ Examples:
         writeManifest(localPath, manifest);
         emit('mcp.add', { module: 'mcp', server: name });
         console.log(chalk.green(`Added MCP server '${name}' to manifest`));
-        console.log(chalk.gray('Run: agents mcp register to apply'));
+        console.log(chalk.gray('Run: agents sync --mcp to apply'));
     });
     withAliases(mcpCmd
         .command('remove [name]'), 'remove')
@@ -565,81 +565,6 @@ Examples:
         }
         console.log();
     });
-    // Deprecated: superseded by `agents sync --mcp`. Kept as a warned, functional
-    // alias so old muscle-memory and scripts don't break.
-    mcpCmd
-        .command('register [name]', { hidden: true })
-        .description('Deprecated — use `agents sync --mcp` instead.')
-        .option('-a, --agents <list>', 'Override manifest targets: claude, codex@0.116.0')
-        .option('-y, --yes', 'Auto-install any missing agent versions without prompting')
-        .addHelpText('after', `
-Examples:
-  # Register all servers from manifest
-  agents mcp register
-
-  # Register a specific server
-  agents mcp register notion
-
-  # Register to specific agents (overrides manifest config)
-  agents mcp register --agents codex@0.116.0
-`)
-        .action(async (name, options) => {
-        console.warn(chalk.yellow('`agents mcp register` is deprecated — use `agents sync --mcp` instead:'));
-        console.warn(chalk.gray('  all servers:     agents sync --mcp'));
-        console.warn(chalk.gray('  specific server: agents sync --mcp <name>'));
-        const localPath = getUserAgentsDir();
-        const manifest = readManifest(localPath);
-        if (!manifest?.mcp) {
-            console.log(chalk.yellow('No MCP servers in manifest'));
-            return;
-        }
-        const entries = name
-            ? (() => {
-                const config = manifest.mcp?.[name];
-                return config ? [[name, config]] : [];
-            })()
-            : Object.entries(manifest.mcp);
-        if (entries.length === 0) {
-            console.log(chalk.yellow(`MCP server '${name}' not found in manifest`));
-            return;
-        }
-        for (const [mcpName, config] of entries) {
-            const transport = config.transport || 'stdio';
-            const commandOrUrl = transport === 'http' ? config.url : config.command;
-            if (!commandOrUrl) {
-                console.log(`\n  ${chalk.cyan(mcpName)}: ${chalk.yellow(`missing ${transport === 'http' ? 'url' : 'command'}`)}`);
-                continue;
-            }
-            console.log(`\n  ${chalk.cyan(mcpName)}:`);
-            let targets;
-            if (options.agents) {
-                const resolved = await resolveInstalledAgentTargetsAutoInstalling(options.agents, capableAgents('mcp'), { yes: options.yes });
-                if (!resolved) {
-                    console.log(chalk.gray('  Cancelled.'));
-                    continue;
-                }
-                targets = resolved;
-            }
-            else {
-                targets = resolveConfiguredAgentTargets(config.agents, config.agentVersions, capableAgents('mcp'));
-            }
-            const results = await registerMcpToTargets(targets, mcpName, commandOrUrl, config.scope || 'user', transport, { headers: config.headers });
-            const applied = results.filter(r => r.success).length;
-            for (const result of results) {
-                if (result.success) {
-                    console.log(`    ${chalk.green('+')} ${formatTargetLabel(result.agentId, result.version)}`);
-                }
-                else if (result.error?.startsWith('skipped:')) {
-                    console.log(`    ${chalk.yellow('-')} ${formatTargetLabel(result.agentId, result.version)}: ${result.error}`);
-                }
-                else {
-                    console.log(`    ${chalk.red('x')} ${formatTargetLabel(result.agentId, result.version)}: ${result.error}`);
-                }
-            }
-            if (applied > 0)
-                emit('mcp.register', { module: 'mcp', server: mcpName, applied });
-        }
-    });
 }
 async function installMcpsFromRepoSource(source, options) {
     const spinner = ora('Cloning repository...').start();

package/dist/commands/memory.js

@@ -7,9 +7,9 @@
 import { withAliases } from '../lib/verbs.js';
 import chalk from 'chalk';
 import * as fs from 'fs';
-import { listMemoryFacts, addMemoryFact, removeMemoryFact, readMemoryFact, ensureUserMemoryDir, getUserMemoryDir, syncMemoryToVersionHome, } from '../lib/memory.js';
+import { listMemoryFacts, addMemoryFact, removeMemoryFact, readMemoryFact, getUserMemoryDir, syncMemoryToVersionHome, } from '../lib/memory.js';
 import { capableAgents } from '../lib/capabilities.js';
-import { resolveAgentName, formatAgentError, agentLabel, ALL_AGENT_IDS } from '../lib/agents.js';
+import { ALL_AGENT_IDS } from '../lib/agents.js';
 import { listInstalledVersions, getVersionHomePath, } from '../lib/installations/versions.js';
 import { supports } from '../lib/capabilities.js';
 import { setHelpSections } from '../lib/help.js';
@@ -33,7 +33,7 @@ export function registerMemoryCommands(program) {
       agents memory remove preferred-editor
 
       # Fan out to all capable installed agent versions
-      agents memory sync
+      agents sync --memory
     `,
         notes: `
       Memory is the knowledge store (learned facts), distinct from rules
@@ -84,7 +84,7 @@ export function registerMemoryCommands(program) {
             }
         }
         else {
-            console.log(chalk.gray('  Run: agents memory sync  (or agents sync) to fan out'));
+            console.log(chalk.gray('  Run: agents sync --memory to fan out'));
         }
     });
     withAliases(memoryCmd
@@ -111,49 +111,6 @@ export function registerMemoryCommands(program) {
         console.log(chalk.dim(`# ${fact.name}  [${fact.layer}]  ${fact.path}`));
         console.log(fs.readFileSync(fact.path, 'utf-8'));
     });
-    // Deprecated: superseded by `agents sync --memory`. Kept as a warned, functional
-    // alias so old muscle-memory and scripts don't break.
-    memoryCmd
-        .command('sync [agent]', { hidden: true })
-        .description('Deprecated — use `agents sync --memory` instead.')
-        .option('-a, --agent <agent>', 'Limit to one agent (or agent@version)')
-        .action(async (agentArg, options) => {
-        console.warn(chalk.yellow('`agents memory sync` is deprecated — use `agents sync --memory` instead:'));
-        console.warn(chalk.gray('  all agents:  agents sync --memory'));
-        console.warn(chalk.gray('  one agent:   agents sync --memory <agent>'));
-        ensureUserMemoryDir();
-        const input = agentArg || options.agent;
-        if (input) {
-            const parts = input.split('@');
-            const resolved = resolveAgentName(parts[0]);
-            if (!resolved) {
-                console.error(chalk.red(formatAgentError(parts[0], capableAgents('memory'))));
-                process.exit(1);
-            }
-            const agent = resolved;
-            const versions = parts[1]
-                ? [parts[1]]
-                : listInstalledVersions(agent);
-            if (versions.length === 0) {
-                console.log(chalk.yellow(`No installed versions of ${agentLabel(agent)}`));
-                return;
-            }
-            for (const version of versions) {
-                const home = getVersionHomePath(agent, version);
-                const facts = syncMemoryToVersionHome(agent, home, process.cwd());
-                console.log(chalk.green(`Synced ${facts.length} fact(s) → ${agent}@${version}`));
-            }
-            return;
-        }
-        const results = syncAllMemory(process.cwd());
-        if (results.length === 0) {
-            console.log(chalk.gray('No memory-capable agent versions installed.'));
-            return;
-        }
-        for (const r of results) {
-            console.log(chalk.green(`Synced ${r.facts.length} fact(s) → ${r.agent}@${r.version}`));
-        }
-    });
 }
 function syncAllMemory(cwd) {
     const out = [];

package/dist/commands/message.d.ts

@@ -3,7 +3,7 @@
  *
  * Delivery is routed by agent state (RUSH-1474):
  *   - running, between tool calls → mailbox spool (PreToolUse inject)
- *   - parked on AskUserQuestion with a tmux/iterm/pty rail → keystroke inject
+ *   - parked on AskUserQuestion with a tmux/iterm rail → keystroke inject
  *   - parked headless (no rail) → `agents run --resume <id> -- <answer>`
  *   - cloud task → provider.message()
  *

package/dist/commands/message.js

@@ -153,23 +153,23 @@ async function deliverViaHostReroute(route, text, opts) {
  * injected input a running agent consumes, never a notification a human reads.
  * Mirrors SHARED_NOTES in commands/send.ts so an agent reading either --help
  * sees the same three-plane map and doesn't reach for `message` when it means
- * `send`/`notify`.
+ * `send`.
  */
 const CONTROL_PLANE_NOTES = `
   Planes (do not mix them up):
-    message / sessions inject  - CONTROL a running agent (mailbox answer, PTY keystroke, or resume by runtime)
-    send / notify              - DELIVER a message to a human recipient over a channel provider
-    feed post                  - RECORD progress / milestones (optional broadcast may call send/notify)
+    message / sessions inject  - CONTROL a running agent (mailbox answer, terminal keystroke, or resume by runtime)
+    send                       - DELIVER a message to a human recipient over a channel provider
+    feed post                  - RECORD progress / milestones (optional broadcast may call send)
 
   <text> here is consumed BY THE TARGET AGENT (an answer, a keystroke, or the
   argument to a resume) -- it is not a notification a person reads on their
-  phone. To reach the operator instead, use \`agents send\` / \`agents notify\`
+  phone. To reach the operator instead, use \`agents send --to owner\`
   (or a feed.broadcast \`channel:\` sink).
 `;
 export function registerMessageCommand(program) {
     const messageCmd = program
         .command('message <target> <text>')
-        .description('Send a message to a running or parked agent (mailbox / PTY-select / resume by runtime).')
+        .description('Send a message to a running or parked agent (mailbox / terminal-select / resume by runtime).')
         .option('--from <who>', 'Label recorded as the sender of this message')
         .option('--as <operator>', 'Verified operator id answering a high-consequence block')
         .option('--surface <surface>', 'Surface that is sending this answer (feed, terminal, etc.)', 'cli')
@@ -222,7 +222,7 @@ export function registerMessageCommand(program) {
                         await deliverViaMailbox(res.id, text, block, { from: opts.from, ttlSeconds });
                         return;
                     }
-                    if (route.kind === 'tmux' || route.kind === 'iterm' || route.kind === 'pty') {
+                    if (route.kind === 'tmux' || route.kind === 'iterm') {
                         await deliverViaInject(route, res.id);
                         if (block) {
                             recordMessageReceipt(block.blockId, {

package/dist/commands/plugins.js

@@ -48,7 +48,7 @@ Examples:
   agents plugins view rush-toolkit
 
   # Sync a plugin to specific agents
-  agents plugins sync rush-toolkit claude
+  agents sync --plugin rush-toolkit claude
 
   # Remove a plugin from all agents and delete its source
   agents plugins remove rush-toolkit
@@ -283,98 +283,6 @@ Examples:
         }
         console.log();
     });
-    // Deprecated: superseded by `agents sync --plugin <name>`. Kept as a warned,
-    // functional alias so old muscle-memory and scripts don't break.
-    pluginsCmd
-        .command('sync <name> [agent]', { hidden: true })
-        .description('Deprecated — use `agents sync --plugin <name>` instead.')
-        .option('--allow-exec-surfaces', 'Enable the plugin even when it ships hooks/, .mcp.json, bin/, scripts/, settings.json, or permissions/')
-        .addHelpText('after', `
-Examples:
-  # Sync a plugin to every installed version of an agent
-  agents plugins sync rush-toolkit claude
-
-  # Sync to one specific version (parity with 'agents sync')
-  agents plugins sync rush-toolkit claude@2.1.142
-
-  # Sync to all supported agents (every installed version of each)
-  agents plugins sync rush-toolkit
-
-  # Re-affirm consent for a hooks-bearing plugin
-  agents plugins sync hivemind claude --allow-exec-surfaces
-`)
-        .action(async (name, agentArg, options) => {
-        console.warn(chalk.yellow('`agents plugins sync` is deprecated — use `agents sync --plugin` instead:'));
-        console.warn(chalk.gray(`  agents sync --plugin ${name}`));
-        const plugin = getPlugin(name);
-        if (!plugin) {
-            console.log(chalk.red(`Plugin '${name}' not found`));
-            process.exit(1);
-        }
-        // Accept the same "agent@version" form as `agents sync`. Splitting here
-        // also means an unknown spec is reported cleanly rather than crashing
-        // isCapable() with a bare "claude@2.1.168".
-        let versionArg;
-        let agentName = agentArg;
-        if (agentArg && agentArg.includes('@')) {
-            const at = agentArg.lastIndexOf('@');
-            agentName = agentArg.slice(0, at);
-            versionArg = agentArg.slice(at + 1);
-        }
-        // Determine target agents
-        let targetAgents;
-        if (agentName) {
-            const agentId = agentName;
-            if (!isCapable(agentId, 'plugins')) {
-                console.log(chalk.red(`Agent '${agentName}' does not support plugins`));
-                process.exit(1);
-            }
-            if (!pluginSupportsAgent(plugin, agentId)) {
-                console.log(chalk.red(`Plugin '${name}' does not support ${agentLabel(agentId)}`));
-                process.exit(1);
-            }
-            targetAgents = [agentId];
-        }
-        else {
-            if (versionArg) {
-                console.log(chalk.red(`A version (@${versionArg}) requires naming the agent, e.g. claude@${versionArg}`));
-                process.exit(1);
-            }
-            targetAgents = capableAgents('plugins').filter(a => pluginSupportsAgent(plugin, a));
-        }
-        const allowExec = options.allowExecSurfaces === true;
-        for (const agentId of targetAgents) {
-            const versions = listInstalledVersions(agentId);
-            if (versions.length === 0)
-                continue;
-            // Default to EVERY installed version. The previous behaviour synced only
-            // the global default, which silently skipped non-default versions used
-            // by balanced rotation -- so a rotated version would lack the plugin's
-            // slash commands. An explicit agent@version narrows back to one.
-            let targetVersions;
-            if (versionArg) {
-                if (!versions.includes(versionArg)) {
-                    console.log(chalk.red(`${agentLabel(agentId)} has no installed version ${versionArg} (installed: ${versions.join(', ')})`));
-                    process.exit(1);
-                }
-                targetVersions = [versionArg];
-            }
-            else {
-                targetVersions = versions;
-            }
-            for (const version of targetVersions) {
-                const didSync = allowExec
-                    ? syncPluginToVersion(plugin, agentId, getVersionHomePath(agentId, version), { allowExecSurfaces: true, version }).success
-                    : syncResourcesToVersion(agentId, version, { plugins: [name] }).plugins.length > 0;
-                if (didSync) {
-                    console.log(chalk.green(`Synced ${name} to ${agentLabel(agentId)}@${version}${allowExec ? ' (exec surfaces enabled)' : ''}`));
-                }
-                else {
-                    console.log(chalk.gray(`${name} already synced to ${agentLabel(agentId)}@${version}`));
-                }
-            }
-        }
-    });
     // agents plugins remove [name]
     withAliases(pluginsCmd
         .command('remove [name]'), 'remove')

package/dist/commands/projects.d.ts

@@ -10,8 +10,6 @@
 import type { Command } from 'commander';
 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";
 /**
  * A path-shaped `agents projects view` argument — `.`, `..`, a `~`-prefixed
  * value, or anything containing a path separator — means "auto-detect the
@@ -20,7 +18,7 @@ export declare const PROJECTS_NO_FANOUT_ENV = "AGENTS_PROJECTS_LOCAL";
  */
 export declare function looksLikePath(token: string): boolean;
 /** Machine-readable shape of `agents projects view <path> --json`. */
-export interface ViewDetection {
+interface ViewDetection {
     /** Detected project name, or null when no definition contains the path. */
     name: string | null;
     /** The detected project's Linear binding; fields are null when unbound. */
@@ -121,19 +119,5 @@ 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;
+export {};

package/dist/commands/projects.js

@@ -30,8 +30,9 @@ import { checkRepoSlug } from '../lib/project-doctor.js';
 import { formatFocusAreas, readFocusAreas } from '../lib/project-focus.js';
 import { formatVerdict, scheduleVerdict } from '../lib/project-schedule.js';
 import { buildLinearImportCandidates, validateImportOpts, } from '../lib/project-import.js';
+import { buildProjectPrs } from '../lib/github/project-prs.js';
 /** Recursion guard: a peer answering a probe fan-out never re-fans-out itself. */
-export const PROJECTS_NO_FANOUT_ENV = 'AGENTS_PROJECTS_LOCAL';
+const PROJECTS_NO_FANOUT_ENV = 'AGENTS_PROJECTS_LOCAL';
 /** Max peers named in the skipped note before the rest collapse to `+N`. */
 const SKIPPED_NAME_LIMIT = 4;
 /**
@@ -482,7 +483,7 @@ warnWorkspaces = []) {
  * 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) {
+function resolveDeviceFilter(device, devices) {
     const merged = [
         ...(device ?? []),
         ...(devices ? devices.split(',').map((s) => s.trim()).filter(Boolean) : []),
@@ -490,7 +491,7 @@ export function resolveDeviceFilter(device, devices) {
     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) {
+function printProjectDefinition(def, name) {
     console.log();
     if (def.root)
         console.log(`  ${chalk.dim('root')}     ${def.root}`);
@@ -818,6 +819,91 @@ export function registerProjectsCommands(program) {
         const mode = name ? 'view' : 'status';
         await runProjectCard(name, opts, mode);
     });
+    // ---- prs ----
+    const prsCmd = projects
+        .command('prs <name>')
+        .description('Every OPEN pull request across a project\'s attached repos (drafts included, no author filter).')
+        .option('--json', 'Machine-readable output (the AGI Menu contract shape)')
+        .option('--repo <owner/repo>', 'Restrict to one of the project\'s attached repos')
+        .option('--number <n>', 'Lazy detail: enrich exactly this PR with checks + reviewDecision (requires --repo)')
+        .action(async (name, opts) => {
+        const def = loadProjectDef(name);
+        if (!def) {
+            console.error(chalk.red(`No project named "${name}". List them: agents projects list`));
+            process.exit(1);
+        }
+        let number;
+        if (opts.number !== undefined) {
+            if (!opts.repo) {
+                console.error(chalk.red('--number names one PR in one repo; pass --repo <owner/repo> with it.'));
+                process.exit(1);
+            }
+            // Require the WHOLE token to be digits — Number.parseInt would accept
+            // "12junk" / "12.9" as 12 and silently query the wrong PR.
+            const raw = opts.number.trim();
+            number = /^\d+$/.test(raw) ? Number.parseInt(raw, 10) : NaN;
+            if (!Number.isSafeInteger(number) || number <= 0) {
+                console.error(chalk.red(`--number expects a positive integer, got "${opts.number}".`));
+                process.exit(1);
+            }
+        }
+        let envelope;
+        try {
+            envelope = await buildProjectPrs(def, { repo: opts.repo, number }, undefined);
+        }
+        catch (e) {
+            // A restriction error (repo not attached) is a hard, up-front failure —
+            // distinct from a per-repo fetch failure, which rides in the envelope.
+            console.error(chalk.red(e instanceof Error ? e.message : String(e)));
+            process.exit(1);
+        }
+        if (opts.json) {
+            // A machine caller reads the envelope from stdout regardless of exit
+            // code: `partial` + per-repo `error` ARE the failure signal, and the
+            // successful repositories ride alongside them. So --json always exits 0
+            // (the envelope is authoritative); a native consumer must not discard
+            // stdout on a non-zero exit. Only the human path below exits non-zero.
+            console.log(JSON.stringify(envelope, null, 2));
+            return;
+        }
+        else {
+            for (const r of envelope.repositories) {
+                if (r.error) {
+                    console.log(`${chalk.bold(r.slug)}  ${chalk.red(`— fetch failed: ${r.error}`)}`);
+                    continue;
+                }
+                console.log(`${chalk.bold(r.slug)}  ${chalk.dim(`${r.pullRequests.length} open`)}`);
+                for (const pr of r.pullRequests) {
+                    const draft = pr.isDraft ? chalk.gray(' [draft]') : '';
+                    console.log(`  #${pr.number}${draft}  ${pr.title}  ${chalk.gray(`@${pr.author.login} · ${pr.headRefName}`)}`);
+                }
+            }
+            if (envelope.partial) {
+                console.log(chalk.yellow('\nSome repositories could not be fetched — the list above is incomplete.'));
+            }
+        }
+        // A partial result (any repo fetch failed) is not a clean success.
+        if (envelope.partial)
+            process.exit(1);
+    });
+    setHelpSections(prsCmd, {
+        examples: `
+      agents projects prs rush --json                       # every open PR across rush's repos
+      agents projects prs rush --json --repo phnx-labs/agi-cli
+      agents projects prs rush --json --repo phnx-labs/agi-cli --number 3646  # one PR, with checks + review
+    `,
+        notes: `
+      Repos come from the project definition's attached repos only (repo + repos[].slug);
+      --repo is refused unless it is one of them.
+
+      The list is read from GitHub over REST and paginated in full, drafts included,
+      with no author filter. checks and reviewDecision are null in the list; --number
+      enriches exactly that one PR against its live head SHA.
+
+      A repository whose fetch fails is reported with an error and marks the result
+      partial (JSON reports errors per repository; text mode exits non-zero).
+    `,
+    });
     // ---- edit ----
     projects
         .command('edit <name>')

package/dist/commands/repo.js

@@ -31,8 +31,6 @@ function resolveRepoPath(target) {
 import { applyExtraAliasToVersions, ensureAgentsDir, getExtraRepoDir, getSystemAgentsDir, getUserAgentsDir, readMeta, resolveExtraRepoDir, updateMeta, } from '../lib/state.js';
 import { parseSource, pullRepo, commitAndPush, isGitRepo, isSystemRepoOrigin, adoptRepo, adoptUserRepoIfNeeded, recordUserRepoRemote, resolveUserRepoRemoteUrl, getRemoteUrl, sameGitRemote, displayHomePath, syncRepoGit, } from '../lib/git.js';
 import { DEFAULT_SYSTEM_REPO } from '../lib/types.js';
-import { ALL_AGENT_IDS, isAgentName, resolveAgentName } from '../lib/agents.js';
-import { refresh } from '../lib/refresh.js';
 import { capableAgents } from '../lib/capabilities.js';
 import { getGlobalDefault, getVersionHomePath, listInstalledVersions } from '../lib/installations/versions.js';
 import { syncAllMarketplaces } from '../lib/plugins/plugin-marketplace.js';
@@ -1230,48 +1228,6 @@ Examples:
             }
         }
     });
-    // Deprecated: superseded by `agents sync`. `agents sync --local` runs the same
-    // reconcile stage (sync-umbrella.ts calls this exact `refresh()`), and `agents
-    // sync <agent>` targets one agent — with the added reach `refresh` lacks
-    // (all installed versions, no silent skip when there is no global default).
-    // Hidden from help; kept as a warned, functional alias so old muscle-memory and
-    // scripts don't break. Migrate callers to `agents sync`.
-    repoCmd
-        .command('refresh [agent]', { hidden: true })
-        .description('Deprecated — use `agents sync` instead.')
-        .option('-y, --yes', 'Auto-sync everything without prompting')
-        .option('--skip-clis', 'Skip CLI version install/upgrade from agents.yaml')
-        .action(async (arg, options) => {
-        console.warn(chalk.yellow('`agents repo refresh` is deprecated — use `agents sync` instead:'));
-        console.warn(chalk.gray('  all agents:  agents sync --local'));
-        console.warn(chalk.gray('  one agent:   agents sync <agent>'));
-        let agentFilter;
-        if (arg) {
-            if (!isAgentName(arg)) {
-                console.log(chalk.red(`Unknown agent "${arg}".`));
-                console.log(chalk.gray(`Available: ${ALL_AGENT_IDS.join(', ')}`));
-                process.exitCode = 1;
-                return;
-            }
-            agentFilter = resolveAgentName(arg);
-        }
-        try {
-            await refresh({
-                agentFilter,
-                skipPrompts: options.yes,
-                skipClis: options.skipClis,
-            });
-            console.log(chalk.green('\nRefresh complete'));
-        }
-        catch (err) {
-            if (isPromptCancelled(err)) {
-                console.log(chalk.yellow('\nCancelled'));
-                return;
-            }
-            console.error(chalk.red(err.message));
-            process.exit(1);
-        }
-    });
     const statusCmd = repoCmd
         .command('status [alias]', { hidden: true })
         .description('Alias of `list` (kept for muscle memory). Add --devices-all to report across the fleet.')

package/dist/commands/resource-view.d.ts

@@ -22,7 +22,7 @@ export interface ResourceRow {
     targets: SyncTarget[];
     buildDetail: () => string;
 }
-export interface ResourceViewOptions {
+interface ResourceViewOptions {
     resourcePlural: string;
     resourceSingular: string;
     extraLabel?: string;
@@ -55,7 +55,7 @@ export interface ResourceViewOptions {
 }
 /** Display a resource list: interactive picker in TTY mode, plain table otherwise. */
 export declare function showResourceList(opts: ResourceViewOptions): Promise<void>;
-export interface ResourceLayout {
+interface ResourceLayout {
     mode: 'table' | 'cards';
     nameW: number;
     extraW: number;
@@ -77,4 +77,5 @@ export declare function resourceLayout(cols: number, o: {
 }): ResourceLayout;
 /** Build the sync targets section showing version pills grouped by agent. */
 export declare function buildTargetsSection(targets: SyncTarget[]): string;
+export {};
 /** Pad a string to a fixed width, accounting for ANSI escape codes in length calculation. */

package/dist/commands/resume.d.ts

@@ -1,5 +1,4 @@
 import type { SessionMeta } from '../lib/session/types.js';
-export declare const RESUME_SOURCE_ENV = "AGENTS_RESUME_SOURCE_JSON";
 /** Inspect local archived context after the owner hop fails. Recovery still
  * requires readable content and explicit replay consent before starting a run. */
 export declare function resumeLocalFallbackSource(session: SessionMeta, self?: string): SessionMeta;

package/dist/commands/resume.js

@@ -8,7 +8,8 @@ import chalk from 'chalk';
 import { resolveSessionMetadataValue } from './sessions.js';
 import { sessionOwnerDevice, consumeResumePinned, RESUME_PINNED_ENV } from '../lib/session/resume-owner.js';
 import { machineId } from '../lib/machine-id.js';
-export const RESUME_SOURCE_ENV = 'AGENTS_RESUME_SOURCE_JSON';
+import { takeOverDetachedSession } from '../lib/session/detached.js';
+const RESUME_SOURCE_ENV = 'AGENTS_RESUME_SOURCE_JSON';
 /** Inspect local archived context after the owner hop fails. Recovery still
  * requires readable content and explicit replay consent before starting a run. */
 export function resumeLocalFallbackSource(session, self = machineId()) {
@@ -161,7 +162,9 @@ export async function runStrictResume(sessionId, prompt, options) {
         }
         return;
     }
-    process.exitCode = await delegateLocalResume(pinnedHere ? resumeLocalFallbackSource(outcome.session) : outcome.session, prompt, options);
+    const localSession = pinnedHere ? resumeLocalFallbackSource(outcome.session) : outcome.session;
+    await takeOverDetachedSession(localSession.id);
+    process.exitCode = await delegateLocalResume(localSession, prompt, options);
 }
 /**
  * Spawn the delegated local `agents run --resume` for a session this box owns