@phnx-labs/agents-cli 1.22.35 → 1.22.38

package/dist/commands/profiles.js

@@ -16,9 +16,8 @@ import { parseBundleValue, secretsKeychainItem } from '../lib/secrets/index.js';
 import { readBundle } from '../lib/secrets/bundles.js';
 import { isInteractiveTerminal } from './utils.js';
 import { getAgentsInvocation } from '../lib/daemon.js';
-import { getActiveResourceProfileName, getResourceProfilePreset, listResourceProfileNames, setActiveResourceProfile, upsertResourceProfilePreset, validateResourceProfileName, } from '../lib/resource-profiles.js';
-import { AGENTS, ALL_AGENT_IDS } from '../lib/agents.js';
-import { listInstalledVersions, syncResourcesToVersion } from '../lib/versions.js';
+import { ALL_AGENT_IDS } from '../lib/agents.js';
+import { findAccount } from '../lib/account-registry.js';
 /**
  * Pure helper: builds a Profile from collected wizard inputs. Extracted so the
  * shape of preset->profile mapping for the `create` wizard is unit-testable
@@ -159,6 +158,9 @@ export async function applyFromSecrets(profile, spec, explicitAuthProvider, opts
  */
 export async function addProfile(name, opts, label = 'Profile') {
     validateProfileName(name);
+    const account = opts.account ? findAccount(opts.account) : null;
+    if (opts.account && !account)
+        throw new Error(`Unknown account '${opts.account}'.`);
     if (profileExists(name) && !opts.force) {
         throw new Error(`${label} '${name}' already exists. Use --force to overwrite.`);
     }
@@ -190,6 +192,10 @@ export async function addProfile(name, opts, label = 'Profile') {
             provider: opts.authProvider,
             authEnvVar,
         });
+        if (account) {
+            profile.account = account.id;
+            profile.provider = account.provider;
+        }
         if (opts.fromSecrets)
             await applyFromSecrets(profile, opts.fromSecrets, opts.authProvider);
         writeProfile(profile);
@@ -204,10 +210,14 @@ export async function addProfile(name, opts, label = 'Profile') {
         throw new Error(`No preset '${presetName}'.\nAvailable presets: ${listPresets().map((p) => p.name).join(', ')}\n` +
             'Or build a custom harness: --host <agent> --model <id>.');
     }
-    if (!opts.fromSecrets && !preset.authOptional) {
+    if (!account && !opts.fromSecrets && !preset.authOptional) {
         await ensureProviderToken(preset.provider, preset.signupUrl, opts.keyStdin);
     }
     const profile = profileFromPreset(name, preset, opts.version);
+    if (account) {
+        profile.account = account.id;
+        profile.provider = account.provider;
+    }
     if (opts.fromSecrets)
         await applyFromSecrets(profile, opts.fromSecrets, opts.authProvider);
     writeProfile(profile);
@@ -221,141 +231,8 @@ function renderProfileRow(p) {
     const provider = p.provider || (p.auth?.keychainItem?.split('.')[1]) || '-';
     return `${chalk.cyan(p.name.padEnd(16))} ${host.padEnd(14)} ${provider.padEnd(12)} ${chalk.gray(model)}`;
 }
-function splitList(value) {
-    if (value === undefined)
-        return undefined;
-    return value.split(',').map((part) => part.trim()).filter(Boolean);
-}
-function buildResourceProfileFromOptions(existing, opts) {
-    const next = { ...(existing ?? {}) };
-    if (opts.description !== undefined)
-        next.description = opts.description || undefined;
-    const keys = ['commands', 'skills', 'hooks', 'subagents', 'plugins', 'workflows', 'permissions', 'mcp'];
-    for (const key of keys) {
-        const parsed = splitList(opts[key]);
-        if (parsed !== undefined)
-            next[key] = parsed;
-    }
-    const secrets = splitList(opts.secrets);
-    if (secrets !== undefined)
-        next.secrets = secrets;
-    if (opts.rules !== undefined)
-        next.rules = opts.rules || undefined;
-    return next;
-}
-function printResourceProfile(name, preset, activeName) {
-    const activeMark = activeName === name ? '*' : ' ';
-    const description = preset.description ? `  ${chalk.gray(preset.description)}` : '';
-    console.log(`${activeMark} ${chalk.cyan(name)}${description}`);
-}
-function syncInstalledVersionsForActiveProfile(cwd) {
-    let synced = 0;
-    for (const agent of Object.keys(AGENTS)) {
-        for (const version of listInstalledVersions(agent)) {
-            syncResourcesToVersion(agent, version, undefined, { cwd, force: true });
-            synced++;
-        }
-    }
-    return synced;
-}
-function registerResourceProfileCommands(program) {
-    const cmd = program
-        .command('profile')
-        .description('Activate top-level resource profiles across commands, skills, hooks, rules, MCP, permissions, and secrets.');
-    cmd
-        .command('list')
-        .alias('ls')
-        .description('List top-level resource profiles')
-        .action(() => {
-        const names = listResourceProfileNames();
-        if (names.length === 0) {
-            console.log(chalk.gray('No resource profiles configured.'));
-            console.log(chalk.gray('Try: agents profile set work --skills user:code-review --secrets work'));
-            return;
-        }
-        const active = getActiveResourceProfileName();
-        for (const name of names) {
-            printResourceProfile(name, getResourceProfilePreset(name), active);
-        }
-    });
-    cmd
-        .command('status')
-        .description('Show the active top-level resource profile')
-        .action(() => {
-        const active = getActiveResourceProfileName();
-        if (!active) {
-            console.log(chalk.gray('No resource profile active.'));
-            return;
-        }
-        const preset = getResourceProfilePreset(active);
-        console.log(chalk.bold(active));
-        if (!preset) {
-            console.log(chalk.red('Configured active profile is missing from profiles.presets.'));
-            return;
-        }
-        if (preset.description)
-            console.log(chalk.gray(preset.description));
-        for (const [key, value] of Object.entries(preset)) {
-            if (key === 'description')
-                continue;
-            console.log(`${key}: ${Array.isArray(value) ? value.join(', ') : value}`);
-        }
-    });
-    cmd
-        .command('set <name>')
-        .alias('define')
-        .description('Create or update a top-level resource profile')
-        .option('--description <text>', 'Free-form description')
-        .option('--commands <patterns>', 'Comma-separated command selectors, e.g. system:commit,user:*')
-        .option('--skills <patterns>', 'Comma-separated skill selectors')
-        .option('--hooks <patterns>', 'Comma-separated hook selectors')
-        .option('--subagents <patterns>', 'Comma-separated subagent selectors')
-        .option('--plugins <patterns>', 'Comma-separated plugin selectors')
-        .option('--workflows <patterns>', 'Comma-separated workflow selectors')
-        .option('--permissions <patterns>', 'Comma-separated permission group selectors')
-        .option('--mcp <patterns>', 'Comma-separated MCP server selectors')
-        .option('--rules <preset>', 'Rules preset to compose while active')
-        .option('--secrets <names>', 'Comma-separated secrets bundles, or "*"')
-        .action((name, opts) => {
-        try {
-            validateResourceProfileName(name);
-            const preset = buildResourceProfileFromOptions(getResourceProfilePreset(name), opts);
-            upsertResourceProfilePreset(name, preset);
-            console.log(chalk.green(`Profile '${name}' saved.`));
-        }
-        catch (err) {
-            console.error(chalk.red(err.message));
-            process.exit(1);
-        }
-    });
-    cmd
-        .command('use <name>')
-        .description('Activate a top-level resource profile and reconcile installed versions')
-        .action((name) => {
-        try {
-            setActiveResourceProfile(name);
-            const synced = syncInstalledVersionsForActiveProfile(process.cwd());
-            console.log(chalk.green(`Profile '${name}' active.`));
-            console.log(chalk.gray(`Reconciled ${synced} installed version${synced === 1 ? '' : 's'}.`));
-        }
-        catch (err) {
-            console.error(chalk.red(err.message));
-            process.exit(1);
-        }
-    });
-    cmd
-        .command('clear')
-        .description('Clear the active top-level resource profile and reconcile installed versions')
-        .action(() => {
-        setActiveResourceProfile(null);
-        const synced = syncInstalledVersionsForActiveProfile(process.cwd());
-        console.log(chalk.green('Resource profile cleared.'));
-        console.log(chalk.gray(`Reconciled ${synced} installed version${synced === 1 ? '' : 's'}.`));
-    });
-}
 /** Register the `agents profiles` command tree. */
 export function registerProfilesCommands(program) {
-    registerResourceProfileCommands(program);
     const cmd = program
         .command('profiles')
         .description('Named bundles of (host CLI, endpoint, model, auth) — run Kimi/DeepSeek/Qwen/etc through Claude Code without a proxy.')
@@ -427,28 +304,6 @@ Examples:
   # Fully remove the OpenRouter key from Keychain
   agents profiles logout openrouter
 `);
-    cmd
-        .command('use <name>')
-        .description('Alias for `agents profile use <name>`')
-        .action((name) => {
-        try {
-            setActiveResourceProfile(name);
-            const synced = syncInstalledVersionsForActiveProfile(process.cwd());
-            console.log(chalk.green(`Profile '${name}' active.`));
-            console.log(chalk.gray(`Reconciled ${synced} installed version${synced === 1 ? '' : 's'}.`));
-        }
-        catch (err) {
-            console.error(chalk.red(err.message));
-            process.exit(1);
-        }
-    });
-    cmd
-        .command('status')
-        .description('Alias for `agents profile status`')
-        .action(() => {
-        const active = getActiveResourceProfileName();
-        console.log(active ? active : chalk.gray('No resource profile active.'));
-    });
     cmd
         .command('list')
         .alias('ls')
@@ -609,6 +464,7 @@ Examples:
         .description('Add a profile. If <name> matches a built-in preset, the preset is applied. Prompts for API key (once per provider).')
         .option('--preset <preset>', 'Use a named preset (defaults to <name> if a preset by that name exists)')
         .option('--version <version>', 'Pin the host CLI version (e.g., 2.1.113)')
+        .option('--account <name>', 'Attach an existing durable credential account')
         .option('--key-stdin', 'Read API key from stdin instead of prompting (for scripts/CI)')
         .option('--force', 'Overwrite an existing profile with the same name')
         .addHelpText('after', '\nTo build a custom harness from a host CLI + model in one shot, use `agents harness add`.\n')
@@ -617,7 +473,7 @@ Examples:
         // device routing (see lib/hosts/passthrough.ts). The host+model one-shot
         // lives on `agents harness add`, which owns its own `--host`.
         try {
-            await addProfile(name, { preset: opts.preset, version: opts.version, keyStdin: opts.keyStdin, force: opts.force }, 'Profile');
+            await addProfile(name, { preset: opts.preset, version: opts.version, account: opts.account, keyStdin: opts.keyStdin, force: opts.force }, 'Profile');
         }
         catch (err) {
             console.error(chalk.red(err.message));

package/dist/commands/projects.d.ts

@@ -8,9 +8,18 @@
  * lifecycle state, plan completion, open PRs, and tickets in flight.
  */
 import type { Command } from 'commander';
+import { 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";
+/**
+ * Render `agents projects for-cwd`'s output for a resolved (or absent)
+ * project name — `--json` always prints `{"name": ...}` even on no match, so
+ * a scripted caller can distinguish "ran and found nothing" from a crash;
+ * the plain-text form prints nothing on no match. Returns '' when nothing
+ * should be printed.
+ */
+export declare function formatForCwdOutput(name: string | undefined, json: boolean): string;
 /**
  * One compact trailing note for peers that didn't answer the `--fleet`
  * fan-out — unreachable, running an agents-cli too old to carry `projects
@@ -28,6 +37,25 @@ export declare function formatFleetSkippedNote(skipped: string[]): string;
  * expected answer here (`undefined`), not something to report.
  */
 export declare function originSlug(cwd: string): string | undefined;
+/**
+ * Turn a `--dir` / `--add-dir` value into a `repos[]` row.
+ *
+ * The slug comes from the DIRECTORY'S OWN origin remote, never from its path:
+ * a checkout at `~/src/github.com/muqsitnawaz/agents-cli` whose origin is
+ * `phnx-labs/agents-cli` must record the remote it actually pushes to. Pass
+ * `slugOverride` for a directory with no origin (a vendored tree, a fresh
+ * `git init`).
+ *
+ * The stored `path` is left for `writeProjectDef` to normalize home-relative,
+ * so the same definition re-roots on every machine.
+ */
+export declare function projectRepoFromDir(dir: string, slugOverride?: string): {
+    ok: true;
+    repo: ProjectRepo;
+} | {
+    ok: false;
+    error: string;
+};
 /** One `projects list` row, pre-render. */
 export interface ProjectListRow {
     name: string;

package/dist/commands/projects.js

@@ -21,7 +21,7 @@ import { getActiveSessions } from '../lib/session/active.js';
 import { gatherRemoteActive } from '../lib/session/remote-active.js';
 import { gatherRemoteAgentsJson } from '../lib/remote-agents-json.js';
 import { formatFleetSummary, formatFleetWorkspaces, parseRemoteProbe, probeProjectWorkspaces, workspaceTargetsForDef, workspaceWarnings, } from '../lib/project-probe.js';
-import { listProjectDefs, loadProjectDef, writeProjectDef, removeProjectDef, projectDefPath, isSafeProjectName, validateProjectDef, } from '../lib/projects.js';
+import { listProjectDefs, loadProjectDef, writeProjectDef, removeProjectDef, projectDefPath, isSafeProjectName, validateProjectDef, projectNameForCwd, } from '../lib/projects.js';
 import { rollupSessionsByProject, withDefaultMachine, isDeadStatus, formatDeadSummary, liveDeadSplit, enrichProjectSignals, formatProjectMembersByHost, formatProjectWarnings, } from '../lib/project-status.js';
 import { fetchLinearProjectCounts } from '../lib/linear-project-counts.js';
 import { listLinearProjects, pickLinearProject } from '../lib/linear-projects.js';
@@ -33,6 +33,18 @@ import { buildLinearImportCandidates, validateImportOpts, } from '../lib/project
 export 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;
+/**
+ * Render `agents projects for-cwd`'s output for a resolved (or absent)
+ * project name — `--json` always prints `{"name": ...}` even on no match, so
+ * a scripted caller can distinguish "ran and found nothing" from a crash;
+ * the plain-text form prints nothing on no match. Returns '' when nothing
+ * should be printed.
+ */
+export function formatForCwdOutput(name, json) {
+    if (json)
+        return JSON.stringify({ name: name ?? null });
+    return name ?? '';
+}
 /**
  * One compact trailing note for peers that didn't answer the `--fleet`
  * fan-out — unreachable, running an agents-cli too old to carry `projects
@@ -88,6 +100,34 @@ export function originSlug(cwd) {
         return undefined;
     }
 }
+/**
+ * Turn a `--dir` / `--add-dir` value into a `repos[]` row.
+ *
+ * The slug comes from the DIRECTORY'S OWN origin remote, never from its path:
+ * a checkout at `~/src/github.com/muqsitnawaz/agents-cli` whose origin is
+ * `phnx-labs/agents-cli` must record the remote it actually pushes to. Pass
+ * `slugOverride` for a directory with no origin (a vendored tree, a fresh
+ * `git init`).
+ *
+ * The stored `path` is left for `writeProjectDef` to normalize home-relative,
+ * so the same definition re-roots on every machine.
+ */
+export function projectRepoFromDir(dir, slugOverride) {
+    const abs = path.resolve(expandLocalHome(dir));
+    if (!fs.existsSync(abs))
+        return { ok: false, error: `No such directory: ${abs}` };
+    if (!fs.statSync(abs).isDirectory())
+        return { ok: false, error: `Not a directory: ${abs}` };
+    const slug = slugOverride ?? originSlug(abs);
+    if (!slug) {
+        return {
+            ok: false,
+            error: `${abs} has no origin remote, so its slug cannot be inferred.\n` +
+                `  Name it explicitly: --add-dir ${dir} --slug <owner/repo>`,
+        };
+    }
+    return { ok: true, repo: { slug, path: toHomeRelative(abs) } };
+}
 /**
  * List the workspace's Linear projects and plan their import, binding each to a
  * local checkout under the configured projects root when the names match
@@ -411,9 +451,12 @@ export function registerProjectsCommands(program) {
         examples: `
       agents projects import --from-linear  # the projects you actually track
       agents projects add rush --repo phnx-labs/rush --path apps/web
+      agents projects add rush --root ~/src/rush --dir ~/src/rush-infra  # bind another dir
+      agents projects set rush --add-dir ~/.agents/.system  # bind one more
+      agents projects set rush --rm-dir ~/src/rush-infra    # unbind it again
       agents projects list                 # definitions only (no session scan)
       agents projects list --with-agents   # opt-in local active counts
-      agents projects list --json          # machine-readable defs (Factory uses this)
+      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 status              # every project, across the whole fleet
@@ -425,8 +468,14 @@ export function registerProjectsCommands(program) {
     `,
         notes: `
       Definitions are hand-editable YAML in ~/.agents/projects/ and sync across
-      machines with 'agents push/pull'. Factory reads and writes only through
-      these commands — never ~/.agents/factory/projects.json.
+      machines with 'agents repo push user' / 'agents repo pull user'. AGI EXT
+      reads and writes only through these commands — never
+      ~/.agents/factory/projects.json.
+
+      A project may bind several directories ('--dir' / '--add-dir'). The cwd an
+      agent lands in is 'defaultPath' (else 'root') — set it with --root/--path,
+      not with --dir. Every bound directory other than that cwd rides along as
+      an --add-dir grant (Claude, Codex, Cursor, Kimi, Grok consume it; others ignore).
     `,
     });
     // ---- list ----
@@ -465,6 +514,17 @@ export function registerProjectsCommands(program) {
             console.log(`  ${chalk.bold(row.name.padEnd(w.name))} ${chalk.dim(row.path.padEnd(w.path))} ${chalk.cyan(row.repo.padEnd(w.repo))}${agentsSuffix}`);
         }
     });
+    // ---- for-cwd ----
+    projects
+        .command('for-cwd [cwd]')
+        .description('Resolve a directory to its defined project name (root or a repos[].path/subpath match). Defaults to the current directory.')
+        .option('--json', 'Machine-readable output: {"name": string | null}')
+        .action((cwdArg, opts) => {
+        const name = projectNameForCwd(cwdArg ?? process.cwd(), listProjectDefs());
+        const out = formatForCwdOutput(name, !!opts.json);
+        if (out)
+            console.log(out);
+    });
     // ---- add ----
     projects
         .command('add <name>')
@@ -472,6 +532,7 @@ export function registerProjectsCommands(program) {
         .option('--root <path>', 'Repo / monorepo root (defaults to the current git repo root)')
         .option('--path <subdir>', 'Default cwd for agents (a monorepo subdir)')
         .option('--repo <owner/repo>', 'Primary GitHub slug (defaults to the origin remote)')
+        .option('--dir <path...>', 'A directory this project binds; slug read from its origin. Repeatable')
         .option('--context <path:purpose...>', 'A described starting point; repeatable')
         .option('--goal <objective:measure...>', 'An outcome the project serves; repeatable')
         .option('--linear <url-or-id>', 'Linear project URL or id')
@@ -502,6 +563,18 @@ export function registerProjectsCommands(program) {
             def.defaultPath = `${root.replace(/\/$/, '')}/${opts.path.replace(/^\//, '')}`;
         if (repo)
             def.repo = repo;
+        if (opts.dir?.length) {
+            const repos = [];
+            for (const d of opts.dir) {
+                const r = projectRepoFromDir(d);
+                if (!r.ok) {
+                    console.error(chalk.red(r.error));
+                    process.exit(1);
+                }
+                repos.push(r.repo);
+            }
+            def.repos = repos;
+        }
         if (opts.context?.length)
             def.contexts = opts.context.map(parseContextFlag);
         if (opts.goal?.length)
@@ -513,6 +586,8 @@ export function registerProjectsCommands(program) {
         console.log(chalk.green(`Defined project "${name}"`));
         console.log(chalk.gray(`  ${target}`));
         console.log(chalk.gray(`  root ${def.root}${def.repo ? `  ·  repo ${def.repo}` : ''}`));
+        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). */
@@ -748,6 +823,9 @@ export function registerProjectsCommands(program) {
         .option('--path <subdir>', 'Default cwd for agents (a monorepo subdir)')
         .option('--description <text>', 'One-line description shown on the card')
         .option('--goal <objective:measure...>', 'Replace the goals this project serves; repeatable')
+        .option('--add-dir <path>', 'Bind another directory to this project; repeatable', (val, prev) => [...prev, val], [])
+        .option('--rm-dir <path>', 'Unbind a directory from this project; repeatable', (val, prev) => [...prev, val], [])
+        .option('--slug <owner/repo>', 'Slug for a single --add-dir whose origin cannot be read')
         .action((name, opts) => {
         const def = loadProjectDef(name);
         if (!def) {
@@ -755,10 +833,17 @@ export function registerProjectsCommands(program) {
             process.exit(1);
         }
         const fields = ['repo', 'root', 'path', 'description'].filter((k) => opts[k] !== undefined);
-        if (fields.length === 0 && !opts.goal?.length) {
+        const dirWork = opts.addDir.length > 0 || opts.rmDir.length > 0;
+        if (fields.length === 0 && !opts.goal?.length && !dirWork) {
             console.error(chalk.red('Nothing to set. Pass a field, e.g. --repo <owner/repo>.'));
             process.exit(1);
         }
+        // One --slug cannot name two directories. Refuse rather than guess which
+        // --add-dir it was meant for.
+        if (opts.slug && opts.addDir.length !== 1) {
+            console.error(chalk.red('--slug names a single --add-dir; pass exactly one --add-dir with it.'));
+            process.exit(1);
+        }
         // Load, mutate the named fields, write back — the `link` pattern. NEVER
         // the `add --force` pattern, which rebuilds the def from flags alone and
         // silently drops linear/contexts/integrations that were not re-passed.
@@ -784,12 +869,47 @@ export function registerProjectsCommands(program) {
             }
             def.defaultPath = `${base}/${opts.path.replace(/^\//, '')}`;
         }
+        // --rm-dir before --add-dir, so re-pointing one directory in a single
+        // command (`--rm-dir old --add-dir new`) does what it reads like.
+        const removed = [];
+        for (const d of opts.rmDir) {
+            const target = path.resolve(expandLocalHome(d));
+            const before = def.repos?.length ?? 0;
+            def.repos = (def.repos ?? []).filter((r) => !r.path || path.resolve(expandLocalHome(r.path)) !== target);
+            if ((def.repos.length ?? 0) === before) {
+                console.error(chalk.red(`"${def.name}" does not bind ${target} — nothing to remove.`));
+                process.exit(1);
+            }
+            removed.push(target);
+        }
+        const added = [];
+        for (const d of opts.addDir) {
+            const r = projectRepoFromDir(d, opts.slug);
+            if (!r.ok) {
+                console.error(chalk.red(r.error));
+                process.exit(1);
+            }
+            const target = path.resolve(expandLocalHome(r.repo.path));
+            const dup = (def.repos ?? []).some((x) => x.path && path.resolve(expandLocalHome(x.path)) === target);
+            if (dup) {
+                console.error(chalk.red(`"${def.name}" already binds ${target}.`));
+                process.exit(1);
+            }
+            def.repos = [...(def.repos ?? []), r.repo];
+            added.push(r.repo);
+        }
+        if (def.repos?.length === 0)
+            delete def.repos;
         writeProjectDef(def);
         console.log(chalk.green(`Updated ${def.name}`));
         for (const f of fields)
             console.log(chalk.gray(`  ${f}  ${f === 'path' ? def.defaultPath : def[f]}`));
         if (opts.goal?.length)
             console.log(chalk.gray(`  goals  ${def.goals?.map((g) => g.objective).join(' · ')}`));
+        for (const r of removed)
+            console.log(chalk.gray(`  - dir  ${toHomeRelative(r)}`));
+        for (const r of added)
+            console.log(chalk.gray(`  + dir  ${r.path}  ·  ${r.slug}`));
     });
     // ---- link ----
     projects

package/dist/commands/reconnect.js

@@ -81,11 +81,17 @@ export async function reconnectAction(id) {
     await focusAction(recent.id, {});
 }
 export function registerReconnectCommand(program) {
+    // Deprecated: superseded by `agents sessions resume`, which does the same
+    // attach-else-recover and additionally takes a tmux alias. Hidden + warned +
+    // functional for one release. Bare `reconnect` targeted the most recent
+    // session in this directory; that default now lives on `resume`'s picker.
     const cmd = program
-        .command('reconnect')
+        .command('reconnect', { hidden: true })
         .argument('[session-id]', 'Session id/prefix to reconnect (default: the most recent session started here)')
-        .description('Re-enter a dropped agent terminal: attach the live pane if it survived, else resume the session')
+        .description('Deprecated — use `agents sessions resume` instead.')
         .action(async (id) => {
+        console.warn(chalk.yellow('`agents reconnect` is deprecated — use `agents sessions resume` instead:'));
+        console.warn(chalk.gray(`  agents sessions resume${id ? ` ${id}` : ''}`));
         await reconnectAction(id);
     });
     setHelpSections(cmd, {
@@ -103,7 +109,7 @@ export function registerReconnectCommand(program) {
       - Best-effort recovery: a living remote tmux pane is JOINED (a second client, no fork); a dropped one is RESUMED on its origin device (a copy if it was mid-run, a /continue if idle).
       - With no id, targets the most recent session started from this directory (the terminal that most likely just dropped), not the full fleet picker. Falls back to the most recent session anywhere when this directory has none.
       - This is the manual companion to the automatic reconnect that runs during a live 'agents run --device <box>' when the network blinks; use it after that gave up or the terminal tab closed.
-      - Related: 'agents sessions focus' (attach/recover with a picker) and 'agents sessions resume' (multi-select history -> tabs).
+      - Deprecated: use 'agents sessions resume' — it attaches a live pane, foregrounds a headless session, or recovers an ended one.
     `,
     });
 }

package/dist/commands/repo.js

@@ -29,7 +29,7 @@ function resolveRepoPath(target) {
     return path.join(HOME, `.agents-${trimmed}`);
 }
 import { applyExtraAliasToVersions, ensureAgentsDir, getExtraRepoDir, getSystemAgentsDir, getUserAgentsDir, readMeta, resolveExtraRepoDir, updateMeta, } from '../lib/state.js';
-import { parseSource, pullRepo, commitAndPush, isGitRepo, isSystemRepoOrigin, adoptRepo, getRemoteUrl, sameGitRemote, displayHomePath, } from '../lib/git.js';
+import { parseSource, pullRepo, commitAndPush, isGitRepo, isSystemRepoOrigin, adoptRepo, 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';
@@ -1089,6 +1089,47 @@ export function registerRepoCommands(program) {
             }
         }
     });
+    // agents repo sync <name> — git-level sync for a single DotAgents repo.
+    // Replaces the git portion of the old `agents sync <repo>` verb.
+    // Semantics: system is pull-only (push: false); user and enabled extras push.
+    repoCmd
+        .command('sync <alias>')
+        .description('Git-sync a repo: pull (and push for user/extras). Aliases: "system", "user", or a registered extra.')
+        .addHelpText('after', `
+Examples:
+  # Pull the system repo (read-only mirror)
+  agents repo sync system
+
+  # Pull and push the user repo
+  agents repo sync user
+
+  # Sync a registered extra
+  agents repo sync work
+`)
+        .action(async (alias) => {
+        const targets = collectRepoTargets(alias);
+        if (!targets) {
+            process.exitCode = 1;
+            return;
+        }
+        for (const t of targets) {
+            if (!fs.existsSync(t.dir) || !isGitRepo(t.dir)) {
+                console.log(chalk.yellow(`  ${t.alias}: not a git repo, skipping`));
+                continue;
+            }
+            const push = t.alias !== 'system';
+            const spinner = ora(`Syncing ${formatRepoTarget(t.alias, t.dir)}...`).start();
+            const result = await syncRepoGit(t.dir, { push });
+            if (result.success) {
+                const pushed = result.pushed ? ' (pushed)' : '';
+                spinner.succeed(`${formatRepoTarget(t.alias, t.dir)}: ${result.commit}${pushed}`);
+            }
+            else {
+                spinner.fail(`${formatRepoTarget(t.alias, t.dir)}: ${result.error}`);
+                process.exitCode = 1;
+            }
+        }
+    });
     // 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

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

@@ -35,6 +35,23 @@ export interface ResourceViewOptions {
     filterVersion?: string;
     /** Emit machine-readable JSON instead of the picker/table (for agents/scripts). */
     json?: boolean;
+    /**
+     * Show the "Synced" column. Default true — the central-storage commands all
+     * answer "which agent versions have this?". `agents inspect <repo>` does not:
+     * there the repo IS the source, and empty `targets` would render the
+     * misleading "no installed versions". Set false to drop the column entirely.
+     */
+    showSync?: boolean;
+    /**
+     * Cap for the Name column. Defaults to NAME_CAP (22), which suits the
+     * central-storage commands. Kinds whose rows have no description — hooks are
+     * all script names and no prose — want a wider cap, otherwise four pairs of
+     * `00-agent-verify-work-complete…` truncate to the same string while the
+     * empty Description column wastes the rest of the terminal.
+     */
+    nameCap?: number;
+    /** Per-row OSC-8 link target, keyed by row name; makes names clickable. */
+    linkFor?: (row: ResourceRow) => string | undefined;
 }
 /** Display a resource list: interactive picker in TTY mode, plain table otherwise. */
 export declare function showResourceList(opts: ResourceViewOptions): Promise<void>;