@phnx-labs/agents-cli 1.20.72 → 1.20.74

package/dist/commands/monitors.js

@@ -23,6 +23,12 @@ import { machineId, normalizeHost } from '../lib/machine-id.js';
 import { loadDevices } from '../lib/devices/registry.js';
 import { setHelpSections } from '../lib/help.js';
 import { isInteractiveTerminal, requireInteractiveSelection } from './utils.js';
+function stdoutJson(payload) {
+    process.stdout.write(JSON.stringify(payload) + '\n');
+}
+function stderrLine(message) {
+    process.stderr.write(message + '\n');
+}
 /** A one-line human label for what a monitor watches. */
 function sourceLabel(source) {
     switch (source.type) {
@@ -70,7 +76,7 @@ function ownerLabel(monitor) {
 function ensureDaemonRunning() {
     if (isDaemonRunning()) {
         signalDaemonReload();
-        console.log(chalk.gray('Daemon reloaded'));
+        stderrLine(chalk.gray('Daemon reloaded'));
         return;
     }
     const result = startDaemon();
@@ -79,22 +85,22 @@ function ensureDaemonRunning() {
         console.log(chalk.gray('Stop anytime with: agents routines stop'));
     }
     else {
-        console.log(chalk.yellow('Could not start the daemon. Start it manually with: agents routines start'));
+        stderrLine(chalk.yellow('Could not start the daemon. Start it manually with: agents routines start'));
     }
 }
 /** Validate a single device name against the registered fleet; exit on miss. */
 async function validateDevice(name) {
     const normalized = normalizeHost(name.trim());
     if (!normalized) {
-        console.log(chalk.red('device name must be non-empty'));
+        stderrLine(chalk.red('device name must be non-empty'));
         process.exit(1);
     }
     const registry = await loadDevices();
     const registered = new Set(Object.keys(registry).map((k) => normalizeHost(k)));
     if (!registered.has(normalized)) {
-        console.log(chalk.red(`Unknown device: ${normalized}`));
-        console.log(chalk.gray(`Registered: ${[...registered].sort().join(', ') || '(none)'}`));
-        console.log(chalk.gray('Enroll devices with: agents devices sync'));
+        stderrLine(chalk.red(`Unknown device: ${normalized}`));
+        stderrLine(chalk.gray(`Registered: ${[...registered].sort().join(', ') || '(none)'}`));
+        stderrLine(chalk.gray('Enroll devices with: agents devices sync'));
         process.exit(1);
     }
     return normalized;
@@ -126,7 +132,7 @@ function buildSource(options) {
         const raw = String(options.on);
         const [src, event] = raw.includes(':') ? raw.split(':', 2) : ['github', raw];
         if (src !== 'github' && src !== 'linear') {
-            console.log(chalk.red('--on source must be github or linear'));
+            stderrLine(chalk.red('--on source must be github or linear'));
             process.exit(1);
         }
         const webhook = { source: src, event };
@@ -143,11 +149,11 @@ function buildSource(options) {
         chosen.push({ type: 'webhook', source: { type: 'webhook', webhook } });
     }
     if (chosen.length === 0) {
-        console.log(chalk.red('A source is required: --watch, --poll, --poll-http, --ws, --watch-file, --watch-device, or --on'));
+        stderrLine(chalk.red('A source is required: --watch, --poll, --poll-http, --ws, --watch-file, --watch-device, or --on'));
         process.exit(1);
     }
     if (chosen.length > 1) {
-        console.log(chalk.red(`Exactly one source is allowed; got ${chosen.map((c) => c.type).join(', ')}`));
+        stderrLine(chalk.red(`Exactly one source is allowed; got ${chosen.map((c) => c.type).join(', ')}`));
         process.exit(1);
     }
     return chosen[0].source;
@@ -162,7 +168,7 @@ function buildCondition(options) {
     if (options.every)
         modes.push('every');
     if (modes.length > 1) {
-        console.log(chalk.red('--on-change, --match, and --every are mutually exclusive'));
+        stderrLine(chalk.red('--on-change, --match, and --every are mutually exclusive'));
         process.exit(1);
     }
     const mode = modes[0] ?? (options.match ? 'match' : 'on-change');
@@ -196,11 +202,11 @@ function buildAction(options) {
     if (options.webhookOut)
         chosen.push({ type: 'webhook-out', url: options.webhookOut });
     if (chosen.length === 0) {
-        console.log(chalk.red('An action is required: --run <agent> --prompt, --routine, --notify, or --webhook-out'));
+        stderrLine(chalk.red('An action is required: --run <agent> --prompt, --routine, --notify, or --webhook-out'));
         process.exit(1);
     }
     if (chosen.length > 1) {
-        console.log(chalk.red(`Exactly one action is allowed; got ${chosen.map((c) => c.type).join(', ')}`));
+        stderrLine(chalk.red(`Exactly one action is allowed; got ${chosen.map((c) => c.type).join(', ')}`));
         process.exit(1);
     }
     return chosen[0];
@@ -209,7 +215,7 @@ function buildAction(options) {
 async function pickMonitor(message, alternatives = []) {
     const monitors = listMonitors();
     if (monitors.length === 0) {
-        console.log(chalk.yellow('No monitors configured'));
+        stderrLine(chalk.yellow('No monitors configured'));
         return null;
     }
     if (!isInteractiveTerminal()) {
@@ -227,7 +233,7 @@ async function pickMonitor(message, alternatives = []) {
     }
     catch (err) {
         if (err instanceof Error && (err.name === 'ExitPromptError' || err.message.includes('User force closed'))) {
-            console.log(chalk.gray('Cancelled'));
+            stderrLine(chalk.gray('Cancelled'));
             return null;
         }
         throw err;
@@ -322,16 +328,16 @@ export function registerMonitorsCommands(program) {
                 parsed = yaml.parse(fs.readFileSync(resolved, 'utf-8'));
             }
             catch (err) {
-                console.log(chalk.red(`Invalid YAML: ${err.message}`));
+                stderrLine(chalk.red(`Invalid YAML: ${err.message}`));
                 process.exit(1);
             }
             const name = parsed?.name || path.basename(resolved).replace(/\.ya?ml$/, '');
             const config = { enabled: true, ...parsed, name };
             const errors = validateMonitor(config);
             if (errors.length > 0) {
-                console.log(chalk.red('Validation errors:'));
+                stderrLine(chalk.red('Validation errors:'));
                 for (const err of errors)
-                    console.log(chalk.red(`  - ${err}`));
+                    stderrLine(chalk.red(`  - ${err}`));
                 process.exit(1);
             }
             writeMonitor(config);
@@ -340,8 +346,8 @@ export function registerMonitorsCommands(program) {
             return;
         }
         if (!nameOrPath) {
-            console.log(chalk.red('Monitor name is required'));
-            console.log(chalk.gray('Usage: agents monitors add <name> --poll "<cmd>" 30s --match fail --run claude --prompt "..."'));
+            stderrLine(chalk.red('Monitor name is required'));
+            stderrLine(chalk.gray('Usage: agents monitors add <name> --poll "<cmd>" 30s --match fail --run claude --prompt "..."'));
             process.exit(1);
         }
         const source = buildSource(options);
@@ -357,7 +363,7 @@ export function registerMonitorsCommands(program) {
         let device;
         let devices;
         if (options.device && options.devices) {
-            console.log(chalk.red('--device (single owner) and --devices (allowlist) are mutually exclusive'));
+            stderrLine(chalk.red('--device (single owner) and --devices (allowlist) are mutually exclusive'));
             process.exit(1);
         }
         if (options.device)
@@ -371,13 +377,13 @@ export function registerMonitorsCommands(program) {
         // --run-on with no owner pin would fire from every daemon → duplicate actions.
         if (options.runOn && !device && !devices) {
             device = machineId();
-            console.log(chalk.gray(`--run-on set with no --device/--devices: pinned owner to this machine (${device}).`));
+            stderrLine(chalk.gray(`--run-on set with no --device/--devices: pinned owner to this machine (${device}).`));
         }
         let rateLimit;
         if (options.rateLimit) {
             const m = String(options.rateLimit).match(/^(\d+)\/(.+)$/);
             if (!m) {
-                console.log(chalk.red('--rate-limit must be N/<interval>, e.g. 5/1m'));
+                stderrLine(chalk.red('--rate-limit must be N/<interval>, e.g. 5/1m'));
                 process.exit(1);
             }
             rateLimit = { max: parseInt(m[1], 10), per: m[2] };
@@ -395,15 +401,15 @@ export function registerMonitorsCommands(program) {
         };
         const errors = validateMonitor(config);
         if (errors.length > 0) {
-            console.log(chalk.red('Validation errors:'));
+            stderrLine(chalk.red('Validation errors:'));
             for (const err of errors)
-                console.log(chalk.red(`  - ${err}`));
+                stderrLine(chalk.red(`  - ${err}`));
             process.exit(1);
         }
         // Coverage lint (Anthropic's "silence is not success"): warn when a --match
         // names only a success-shaped token with no failure branch.
         if (condition.mode === 'match' && condition.match && /^(issued|success|ok|pass(ed)?|done|ready)$/i.test(condition.match)) {
-            console.log(chalk.yellow(`  Note: --match '${condition.match}' only fires on success — it stays silent if the source breaks or never matches.`));
+            stderrLine(chalk.yellow(`  Note: --match '${condition.match}' only fires on success — it stays silent if the source breaks or never matches.`));
         }
         writeMonitor(config);
         console.log(chalk.green(`Monitor '${nameOrPath}' added`));
@@ -432,7 +438,7 @@ export function registerMonitorsCommands(program) {
                     lastFiredAt: state?.lastFiredAt ?? null,
                 };
             });
-            process.stdout.write(JSON.stringify(payload) + '\n');
+            stdoutJson(payload);
             return;
         }
         if (monitors.length === 0) {
@@ -456,7 +462,8 @@ export function registerMonitorsCommands(program) {
     monitorsCmd
         .command('view [name]')
         .description('Show a monitor’s full YAML config plus its current watched-state and recent fires.')
-        .action(async (name) => {
+        .option('--json', 'Emit machine-readable JSON')
+        .action(async (name, options) => {
         if (!name) {
             name = (await pickMonitor('Select monitor to view', ['agents monitors view <name>'])) ?? undefined;
             if (!name)
@@ -464,12 +471,24 @@ export function registerMonitorsCommands(program) {
         }
         const monitor = readMonitor(name);
         if (!monitor) {
-            console.log(chalk.red(`Monitor '${name}' not found`));
+            stderrLine(chalk.red(`Monitor '${name}' not found`));
             process.exit(1);
         }
+        const state = readState(name);
+        const recentFires = listFires(name).slice(-5);
+        if (options.json) {
+            stdoutJson({
+                name,
+                monitor,
+                owner: ownerLabel(monitor),
+                runsHere: monitorRunsOnThisDevice(monitor),
+                state,
+                recentFires,
+            });
+            return;
+        }
         console.log(chalk.bold(`Monitor: ${name}\n`));
         console.log(yaml.stringify(monitor));
-        const state = readState(name);
         if (state) {
             console.log(chalk.bold('Watched state'));
             console.log(chalk.gray(`  last seen:  ${state.lastSeenAt}`));
@@ -477,10 +496,9 @@ export function registerMonitorsCommands(program) {
                 console.log(chalk.gray(`  last fired: ${state.lastFiredAt}`));
             console.log(chalk.gray(`  last value: ${state.lastValue.replace(/\s+/g, ' ').slice(0, 120)}`));
         }
-        const fires = listFires(name).slice(-5);
-        if (fires.length > 0) {
+        if (recentFires.length > 0) {
             console.log(chalk.bold('\nRecent fires'));
-            for (const f of fires) {
+            for (const f of recentFires) {
                 console.log(`  ${chalk.gray(f.firedAt)}  ${f.action ?? '?'}  ${f.ok === false ? chalk.red('failed') : chalk.green('ok')}`);
             }
         }
@@ -489,7 +507,8 @@ export function registerMonitorsCommands(program) {
     monitorsCmd
         .command('test [name]')
         .description('DRY-RUN: evaluate the source once and print the emitted event + whether it would fire. No action is taken.')
-        .action(async (name) => {
+        .option('--json', 'Emit machine-readable JSON')
+        .action(async (name, options) => {
         if (!name) {
             name = (await pickMonitor('Select monitor to test', ['agents monitors test <name>'])) ?? undefined;
             if (!name)
@@ -497,12 +516,24 @@ export function registerMonitorsCommands(program) {
         }
         const monitor = readMonitor(name);
         if (!monitor) {
-            console.log(chalk.red(`Monitor '${name}' not found`));
+            stderrLine(chalk.red(`Monitor '${name}' not found`));
             process.exit(1);
         }
+        const { observation, decision } = await evaluateMonitorOnce(monitor);
+        const wouldFire = Boolean(decision?.fire);
+        if (options.json) {
+            stdoutJson({
+                name,
+                dryRun: true,
+                monitor,
+                observation,
+                decision,
+                wouldFire,
+            });
+            return;
+        }
         console.log(chalk.bold(`Dry-run: ${name}\n`));
         console.log(chalk.gray(`  ${sourceLabel(monitor.source)}  ·  [${monitor.condition.mode}]  ·  ${actionLabel(monitor.action)}\n`));
-        const { observation, decision } = await evaluateMonitorOnce(monitor);
         if (!observation) {
             console.log(chalk.yellow('No observation — this source is push-only (ws/webhook) or produced nothing this tick.'));
             return;
@@ -511,7 +542,6 @@ export function registerMonitorsCommands(program) {
         console.log(observation.raw.split('\n').slice(0, 20).map((l) => `  ${l}`).join('\n'));
         if (observation.meta)
             console.log(chalk.gray(`  meta: ${JSON.stringify(observation.meta)}`));
-        const wouldFire = Boolean(decision?.fire);
         console.log('');
         console.log(`Would fire: ${wouldFire ? chalk.green('yes') : chalk.gray('no')}`);
         if (decision?.event) {
@@ -560,15 +590,15 @@ export function registerMonitorsCommands(program) {
                 return;
             const errors = validateMonitor(monitor);
             if (errors.length > 0) {
-                console.log(chalk.yellow('\nWarning: monitor has validation errors:'));
+                stderrLine(chalk.yellow('\nWarning: monitor has validation errors:'));
                 for (const err of errors)
-                    console.log(chalk.yellow(`  - ${err}`));
+                    stderrLine(chalk.yellow(`  - ${err}`));
             }
             else {
                 console.log(chalk.green(`\nMonitor '${name}' saved`));
                 if (isDaemonRunning()) {
                     signalDaemonReload();
-                    console.log(chalk.gray('Daemon reloaded'));
+                    stderrLine(chalk.gray('Daemon reloaded'));
                 }
             }
         });
@@ -587,14 +617,14 @@ export function registerMonitorsCommands(program) {
         }
         const run = options.run ? listRuns(name).find((r) => r.runId === options.run) : getLatestRun(name);
         if (!run) {
-            console.log(chalk.yellow(`No action runs found for monitor '${name}'`));
-            console.log(chalk.gray('  (notify / webhook-out actions have no run log — see: agents monitors runs)'));
+            stderrLine(chalk.yellow(`No action runs found for monitor '${name}'`));
+            stderrLine(chalk.gray('  (notify / webhook-out actions have no run log — see: agents monitors runs)'));
             return;
         }
         const logPath = path.join(getRunDir(name, run.runId), 'stdout.log');
         if (options.full) {
             if (!fs.existsSync(logPath)) {
-                console.log(chalk.yellow(`Log not found: ${logPath}`));
+                stderrLine(chalk.yellow(`Log not found: ${logPath}`));
                 return;
             }
             console.log(chalk.gray(`Run: ${run.runId}\n`));
@@ -628,7 +658,7 @@ export function registerMonitorsCommands(program) {
         }
         const fires = listFires(name);
         if (fires.length === 0) {
-            console.log(chalk.yellow(`No fires recorded for monitor '${name}'`));
+            stderrLine(chalk.yellow(`No fires recorded for monitor '${name}'`));
             return;
         }
         console.log(chalk.bold(`Fire history: ${name}\n`));
@@ -656,7 +686,7 @@ export function registerMonitorsCommands(program) {
                 signalDaemonReload();
         }
         catch (err) {
-            console.log(chalk.red(err.message));
+            stderrLine(chalk.red(err.message));
             process.exit(1);
         }
     });
@@ -676,7 +706,7 @@ export function registerMonitorsCommands(program) {
                 signalDaemonReload();
         }
         catch (err) {
-            console.log(chalk.red(err.message));
+            stderrLine(chalk.red(err.message));
             process.exit(1);
         }
     });
@@ -688,7 +718,7 @@ export function registerMonitorsCommands(program) {
         .option('--clear', 'Remove the owner pin so the monitor runs on every device')
         .action(async (name, options) => {
         if (options.set !== undefined && options.clear) {
-            console.log(chalk.red('--set and --clear are mutually exclusive'));
+            stderrLine(chalk.red('--set and --clear are mutually exclusive'));
             process.exit(1);
         }
         if (!name) {
@@ -698,7 +728,7 @@ export function registerMonitorsCommands(program) {
         }
         const monitor = readMonitor(name);
         if (!monitor) {
-            console.log(chalk.red(`Monitor '${name}' not found`));
+            stderrLine(chalk.red(`Monitor '${name}' not found`));
             process.exit(1);
         }
         if (options.clear) {
@@ -737,11 +767,11 @@ export function registerMonitorsCommands(program) {
             console.log(chalk.green(`Monitor '${name}' removed`));
             if (isDaemonRunning()) {
                 signalDaemonReload();
-                console.log(chalk.gray('Daemon reloaded'));
+                stderrLine(chalk.gray('Daemon reloaded'));
             }
         }
         else {
-            console.log(chalk.red(`Monitor '${name}' not found`));
+            stderrLine(chalk.red(`Monitor '${name}' not found`));
             process.exit(1);
         }
     });

package/dist/commands/plugins.js

@@ -493,6 +493,7 @@ Examples:
     // agents plugins install <spec>
     pluginsCmd
         .command('install <spec>')
+        .alias('add')
         .description('Install a plugin from a git URL or local path (format: name@source or source)')
         .option('--allow-exec-surfaces', 'Allow installing plugins that ship executable surfaces')
         .addHelpText('after', `

package/dist/commands/profiles.js

@@ -14,6 +14,9 @@ import { getPreset, listPresets, expandPreset } from '../lib/profiles-presets.js
 import { hasKeychainToken, keychainItemName, setKeychainToken, deleteKeychainToken, } from '../lib/secrets/profiles.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 } from '../lib/agents.js';
+import { listInstalledVersions, syncResourcesToVersion } from '../lib/versions.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
@@ -69,8 +72,141 @@ 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.')
@@ -142,6 +278,28 @@ 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')

package/dist/commands/repo.js

@@ -6,7 +6,7 @@ import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';
 import simpleGit from 'simple-git';
-import { confirm, input } from '@inquirer/prompts';
+import { input } from '@inquirer/prompts';
 import { isInteractiveTerminal, isPromptCancelled } from './utils.js';
 import { setHelpSections } from '../lib/help.js';
 import { itemPicker } from '../lib/picker.js';
@@ -843,66 +843,8 @@ export function registerRepoCommands(program) {
                     continue;
                 }
             }
-            if (t.alias === 'system') {
+            if (t.alias === 'system' && alias !== 'system') {
                 // Skip system repo unless explicitly requested
-                if (alias !== 'system')
-                    continue;
-                // User explicitly asked for system repo — show status and offer to pull
-                try {
-                    const git = simpleGit(t.dir);
-                    await git.fetch();
-                    const status = await git.status();
-                    const behind = status.behind ?? 0;
-                    if (behind === 0) {
-                        console.log(chalk.green('Up to date'));
-                    }
-                    else {
-                        // Count changed resources by type
-                        const diff = await git.diff(['--name-only', 'HEAD..@{upstream}']);
-                        const files = diff.split('\n').filter(Boolean);
-                        const counts = {};
-                        for (const f of files) {
-                            if (f.startsWith('skills/'))
-                                counts['skills'] = (counts['skills'] || 0) + 1;
-                            else if (f.startsWith('commands/'))
-                                counts['commands'] = (counts['commands'] || 0) + 1;
-                            else if (f.startsWith('hooks/'))
-                                counts['hooks'] = (counts['hooks'] || 0) + 1;
-                            else if (f.startsWith('rules/'))
-                                counts['rules'] = (counts['rules'] || 0) + 1;
-                            else
-                                counts['other'] = (counts['other'] || 0) + 1;
-                        }
-                        const parts = [];
-                        if (counts['skills'])
-                            parts.push(`${counts['skills']} skill${counts['skills'] > 1 ? 's' : ''}`);
-                        if (counts['commands'])
-                            parts.push(`${counts['commands']} command${counts['commands'] > 1 ? 's' : ''}`);
-                        if (counts['hooks'])
-                            parts.push(`${counts['hooks']} hook${counts['hooks'] > 1 ? 's' : ''}`);
-                        if (counts['rules'])
-                            parts.push(`${counts['rules']} rule${counts['rules'] > 1 ? 's' : ''}`);
-                        if (counts['other'])
-                            parts.push(`${counts['other']} other`);
-                        const summary = parts.length > 0 ? parts.join(', ') : `${behind} update${behind > 1 ? 's' : ''}`;
-                        console.log(chalk.yellow(`${summary} available`));
-                        if (isInteractiveTerminal()) {
-                            const doPull = await confirm({ message: 'Pull now?', default: true });
-                            if (doPull) {
-                                const result = await pullRepo(t.dir);
-                                if (result.success) {
-                                    console.log(chalk.green('Updated'));
-                                }
-                                else {
-                                    console.log(chalk.red(result.error || 'Pull failed'));
-                                }
-                            }
-                        }
-                    }
-                }
-                catch (err) {
-                    console.log(chalk.red(err.message));
-                }
                 continue;
             }
             const spinner = ora(`Pulling ${formatRepoTarget(t.alias, t.dir)}...`).start();

package/dist/commands/resources.d.ts

@@ -0,0 +1,5 @@
+/**
+ * `agents resources` — show the merged DotAgents resource surface.
+ */
+import type { Command } from 'commander';
+export declare function registerResourcesCommand(program: Command): void;