@phnx-labs/agents-cli 1.14.7 → 1.16.0

package/dist/commands/{init.js → setup.js}

@@ -1,7 +1,7 @@
 /**
- * First-run initialization command.
+ * First-run setup command.
  *
- * Registers the `agents init` command which clones the system repo into
+ * Registers the `agents setup` command which clones the system repo into
  * ~/.agents-system/ and installs agent CLIs with resource syncing.
  */
 import chalk from 'chalk';
@@ -52,13 +52,13 @@ async function importAgent(agentId, version) {
     }
 }
 /** First-run setup. Clones ~/.agents-system/ from the system repo if needed. */
-export async function runInit(program, options = {}) {
+export async function runSetup(program, options = {}) {
     const agentsDir = getAgentsDir();
     const alreadyConfigured = isGitRepo(agentsDir);
     if (alreadyConfigured && !options.force) {
         console.log(chalk.gray('~/.agents-system/ is already set up.'));
         console.log(chalk.gray('\nTo sync updates:      agents repo pull system'));
-        console.log(chalk.gray('To re-initialize:     agents init --force'));
+        console.log(chalk.gray('To re-run setup:      agents setup --force'));
         return;
     }
     // Detect existing installations BEFORE cloning (they won't exist after if we import)
@@ -76,16 +76,26 @@ export async function runInit(program, options = {}) {
         const result = await pullRepo(agentsDir);
         if (!result.success) {
             spinner.fail(`Pull failed: ${result.error}`);
-            console.log(chalk.gray('Fix the issue and re-run: agents init --force'));
+            console.log(chalk.gray('Fix the issue and re-run: agents setup --force'));
             process.exit(1);
         }
         spinner.succeed(`Updated to ${result.commit}`);
     }
     else {
+        // Check git is available
+        try {
+            const { execSync } = await import('child_process');
+            execSync('which git', { stdio: 'ignore' });
+        }
+        catch {
+            spinner.fail('git is not installed');
+            console.log(chalk.gray('Install git first: https://git-scm.com/downloads'));
+            process.exit(1);
+        }
         const result = await cloneIntoExisting(DEFAULT_SYSTEM_REPO, agentsDir);
         if (!result.success) {
             spinner.fail(`Clone failed: ${result.error}`);
-            console.log(chalk.gray('Fix the issue and re-run: agents init --force'));
+            console.log(chalk.gray('Fix the issue and re-run: agents setup --force'));
             process.exit(1);
         }
         spinner.succeed(`Cloned ${systemRepoSlug(DEFAULT_SYSTEM_REPO)} (${result.commit})`);
@@ -146,6 +156,8 @@ export async function runInit(program, options = {}) {
             }
         }
     }
+    if (options.suppressFooter)
+        return;
     console.log(chalk.bold('\nSetup complete. Try:'));
     console.log(chalk.cyan('  agents view                 ') + chalk.gray(' # see what\'s installed'));
     console.log(chalk.cyan('  agents run <agent> "hello"  ') + chalk.gray(' # run an agent'));
@@ -155,7 +167,7 @@ export async function runInit(program, options = {}) {
 /**
  * Ensure the system repo exists before running a command that needs it.
  * If ~/.agents-system/ is not a git repo AND we're in an interactive TTY,
- * prompt the user to run init now. In non-interactive mode, print a clear
+ * prompt the user to run setup now. In non-interactive mode, print a clear
  * error and exit.
  */
 export async function ensureInitialized(program) {
@@ -163,34 +175,33 @@ export async function ensureInitialized(program) {
     if (isGitRepo(agentsDir))
         return;
     if (!isInteractiveTerminal()) {
-        console.error(chalk.red('agents-cli is not initialized. Run: agents init'));
+        console.error(chalk.red('agents-cli is not set up. Run: agents setup'));
         process.exit(1);
     }
     console.log(chalk.yellow('\nagents-cli has not been set up yet.'));
     const proceed = await confirm({
-        message: 'Run `agents init` now?',
+        message: 'Run `agents setup` now?',
         default: true,
     }).catch(() => false);
     if (!proceed) {
-        console.log(chalk.gray('Skipped. Run `agents init` when ready.'));
+        console.log(chalk.gray('Skipped. Run `agents setup` when ready.'));
         process.exit(0);
     }
-    await runInit(program);
-    process.exit(0);
+    await runSetup(program, { suppressFooter: true });
 }
-/** Register the `agents init` command. */
-export function registerInitCommand(program) {
+/** Register the `agents setup` command. */
+export function registerSetupCommand(program) {
     program
-        .command('init')
+        .command('setup')
         .description('Set up agents-cli for the first time. Clones a config repo and installs agent CLIs.')
-        .option('-f, --force', 'Reinitialize even if ~/.agents-system/ already exists (use with caution)')
+        .option('-f, --force', 'Re-run setup even if ~/.agents-system/ already exists (use with caution)')
         .addHelpText('after', `
 Examples:
   # First-time setup (clones the system repo into ~/.agents-system/)
-  agents init
+  agents setup
 
-  # Re-initialize after corruption
-  agents init --force
+  # Re-run setup after corruption
+  agents setup --force
 
 When to use:
   - First time running agents-cli: this is your starting point
@@ -203,12 +214,12 @@ What it does:
   3. Syncs commands, skills, hooks, and MCP servers to each version
 
 Non-interactive alternative:
-  Skip 'init' and run:
+  Skip 'setup' and run:
     agents pull
 `)
         .action(async (options) => {
         try {
-            await runInit(program, options);
+            await runSetup(program, options);
         }
         catch (err) {
             if (isPromptCancelled(err)) {

package/dist/commands/skills.js

@@ -4,12 +4,12 @@ import * as fs from 'fs';
 import * as os from 'os';
 import * as path from 'path';
 import { select, checkbox } from '@inquirer/prompts';
-import { SKILLS_CAPABLE_AGENTS, resolveAgentName, formatAgentError, agentLabel, } from '../lib/agents.js';
+import { AGENTS, SKILLS_CAPABLE_AGENTS, resolveAgentName, formatAgentError, agentLabel, } from '../lib/agents.js';
 import { cloneRepo } from '../lib/git.js';
-import { discoverSkillsFromRepo, installSkillCentrally, uninstallSkill, listInstalledSkills, listInstalledSkillsWithScope, getSkillInfo, getSkillRules, getSkillsDir, countSkillFiles, tryParseSkillMetadata, diffVersionSkills, iterSkillsCapableVersions, } from '../lib/skills.js';
-import { getGlobalDefault, resolveVersionAlias, syncResourcesToVersion, promptAgentVersionSelection, resolveAgentVersionTargets, } from '../lib/versions.js';
+import { discoverSkillsFromRepo, installSkillCentrally, listInstalledSkills, listInstalledSkillsWithScope, getSkillInfo, getSkillRules, getSkillsDir, countSkillFiles, tryParseSkillMetadata, diffVersionSkills, iterSkillsCapableVersions, removeSkillFromVersion, } from '../lib/skills.js';
+import { getGlobalDefault, resolveVersionAlias, syncResourcesToVersion, promptAgentVersionSelection, getVersionHomePath, resolveAgentVersionTargets, } from '../lib/versions.js';
 import { recordVersionResources } from '../lib/state.js';
-import { isPromptCancelled, isInteractiveTerminal, parseCommaSeparatedList, printWithPager, requireInteractiveSelection, } from './utils.js';
+import { isPromptCancelled, isInteractiveTerminal, parseCommaSeparatedList, printWithPager, requireInteractiveSelection, promptRemovalTargets, } from './utils.js';
 import { showResourceList, buildTargetsSection, } from './resource-view.js';
 /** Register the `agents skills` command tree (list, add, remove, sync, prune, view). */
 export function registerSkillsCommands(program) {
@@ -294,15 +294,29 @@ Examples:
   agents skills remove
 `)
         .action(async (name) => {
+        const skillTargetMap = new Map();
+        for (const { agent, version } of iterSkillsCapableVersions()) {
+            const home = getVersionHomePath(agent, version);
+            const skills = listInstalledSkillsWithScope(agent, process.cwd(), { home });
+            for (const skill of skills) {
+                if (skill.scope !== 'user')
+                    continue;
+                const existing = skillTargetMap.get(skill.name);
+                if (existing) {
+                    existing.targets.push({ agent, version });
+                }
+                else {
+                    skillTargetMap.set(skill.name, { name: skill.name, targets: [{ agent, version }] });
+                }
+            }
+        }
         let skillsToRemove;
         if (name) {
             skillsToRemove = [name];
         }
         else {
-            // Interactive picker
-            const installedSkills = listInstalledSkills();
-            if (installedSkills.size === 0) {
-                console.log(chalk.yellow('No skills installed.'));
+            if (skillTargetMap.size === 0) {
+                console.log(chalk.yellow('No skills installed in any version.'));
                 return;
             }
             if (!isInteractiveTerminal()) {
@@ -311,12 +325,13 @@ Examples:
                 ]);
             }
             try {
-                const choices = Array.from(installedSkills.entries()).map(([skillName, skill]) => ({
-                    value: skillName,
-                    name: skill.metadata.description
-                        ? `${skillName} - ${skill.metadata.description}`
-                        : skillName,
-                }));
+                const choices = Array.from(skillTargetMap.values()).map((skill) => {
+                    const agents = [...new Set(skill.targets.map((t) => AGENTS[t.agent].name))];
+                    return {
+                        value: skill.name,
+                        name: `${skill.name} (${agents.join(', ')})`,
+                    };
+                });
                 const selected = await checkbox({
                     message: 'Select skills to remove',
                     choices,
@@ -335,14 +350,40 @@ Examples:
                 throw err;
             }
         }
+        let removed = 0;
         for (const skillName of skillsToRemove) {
-            const result = uninstallSkill(skillName);
-            if (result.success) {
-                console.log(chalk.green(`Removed skill '${skillName}'`));
+            const skillInfo = skillTargetMap.get(skillName);
+            if (!skillInfo || skillInfo.targets.length === 0) {
+                console.log(chalk.yellow(`  Skill '${skillName}' not found in any version.`));
+                continue;
             }
-            else {
-                console.log(chalk.red(result.error || `Failed to remove skill '${skillName}'`));
+            const removalTargets = skillInfo.targets.map((t) => ({
+                agent: t.agent,
+                version: t.version,
+                label: `${agentLabel(t.agent)}@${t.version}`,
+            }));
+            const selectedTargets = await promptRemovalTargets(skillName, removalTargets);
+            if (selectedTargets.length === 0) {
+                console.log(chalk.gray(`  Skipped '${skillName}'.`));
+                continue;
             }
+            for (const target of selectedTargets) {
+                const result = removeSkillFromVersion(target.agent, target.version, skillName);
+                if (result.success) {
+                    console.log(`  ${chalk.red('-')} ${target.label}: ${skillName}`);
+                    removed++;
+                }
+                else if (result.error) {
+                    console.log(`  ${chalk.yellow('!')} ${target.label}: ${result.error}`);
+                }
+            }
+        }
+        if (removed === 0) {
+            console.log(chalk.yellow('No skills removed.'));
+        }
+        else {
+            console.log(chalk.green(`\nRemoved ${removed} skill(s) from version homes.`));
+            console.log(chalk.gray('Central source unchanged. Skills will re-sync on next agent launch.'));
         }
     });
     // `skills sync` is gone — sync runs automatically when the agent launches.

package/dist/commands/subagents.js

@@ -12,10 +12,10 @@ import * as path from 'path';
 import { checkbox } from '@inquirer/prompts';
 import { AGENTS, agentLabel } from '../lib/agents.js';
 import { cloneRepo } from '../lib/git.js';
-import { discoverSubagentsFromRepo, installSubagentCentrally, removeSubagent, listInstalledSubagents, getInstalledSubagent, listSubagentsForAgent, SUBAGENT_CAPABLE_AGENTS, } from '../lib/subagents.js';
+import { discoverSubagentsFromRepo, installSubagentCentrally, listInstalledSubagents, getInstalledSubagent, listSubagentsForAgent, SUBAGENT_CAPABLE_AGENTS, iterSubagentsCapableVersions, removeSubagentFromVersion, } from '../lib/subagents.js';
 import { listInstalledVersions, syncResourcesToVersion, getGlobalDefault, getVersionHomePath, } from '../lib/versions.js';
 import { getSubagentsDir } from '../lib/state.js';
-import { isInteractiveTerminal, isPromptCancelled, requireInteractiveSelection, requireDestructiveArg, } from './utils.js';
+import { isInteractiveTerminal, isPromptCancelled, requireInteractiveSelection, requireDestructiveArg, promptRemovalTargets, } from './utils.js';
 import { showResourceList, buildTargetsSection, } from './resource-view.js';
 /** Replace the home directory prefix with ~ for display. */
 function formatPath(p) {
@@ -240,20 +240,48 @@ Examples:
             console.log(chalk.red(`Subagent '${name}' not found`));
             process.exit(1);
         }
-        const spinner = ora({ text: `Removing ${name}...`, isSilent: !process.stdout.isTTY }).start();
-        const result = removeSubagent(name);
-        if (!result.success) {
-            spinner.fail(`Failed to remove: ${result.error}`);
-            process.exit(1);
+        // Build list of targets that have this subagent synced
+        const availableTargets = [];
+        for (const { agent, version } of iterSubagentsCapableVersions()) {
+            const home = getVersionHomePath(agent, version);
+            const installed = listSubagentsForAgent(agent, home).some((s) => s.name === name);
+            if (installed) {
+                availableTargets.push({ agent, version });
+            }
+        }
+        if (availableTargets.length === 0) {
+            console.log(chalk.yellow(`Subagent '${name}' not synced to any version.`));
+            return;
+        }
+        // Show multi-select picker for targets
+        const removalTargets = availableTargets.map((t) => ({
+            agent: t.agent,
+            version: t.version,
+            label: `${agentLabel(t.agent)}@${t.version}`,
+        }));
+        const selectedTargets = await promptRemovalTargets(name, removalTargets);
+        if (selectedTargets.length === 0) {
+            console.log(chalk.gray('Cancelled.'));
+            return;
         }
-        // Re-sync all installed versions to remove from agent homes
-        for (const agentId of SUBAGENT_CAPABLE_AGENTS) {
-            const versions = listInstalledVersions(agentId);
-            for (const version of versions) {
-                syncResourcesToVersion(agentId, version);
+        let removed = 0;
+        for (const target of selectedTargets) {
+            const result = removeSubagentFromVersion(target.agent, target.version, name);
+            if (result.success) {
+                console.log(`  ${chalk.red('-')} ${target.label}: ${name}`);
+                removed++;
+            }
+            else if (result.error) {
+                console.log(`  ${chalk.yellow('!')} ${target.label}: ${result.error}`);
             }
         }
-        spinner.succeed(`Removed subagent '${name}'`);
+        if (removed === 0) {
+            console.log(chalk.yellow('No subagents removed.'));
+        }
+        else {
+            console.log(chalk.green(`\nRemoved ${removed} subagent(s) from version homes.`));
+            console.log(chalk.gray('Central source unchanged. Subagents will re-sync on next agent launch.'));
+        }
     });
 }
 /** Every (agent, version) that supports subagents and is installed. */

package/dist/commands/teams.js

@@ -922,13 +922,12 @@ Name teammates with --name alice to refer to them as 'alice' instead of a UUID.
         .command('status [team]')
         .aliases(['s', 'st', 'check'])
         .description("Check in on a team: who's working, what files they touched, recent commands, last output. Pass --since for efficient delta polling.")
-        .option('-f, --filter <state>', 'Show only teammates in this state: working, completed, failed, stopped, or all (default: all)', 'all')
+        .option('-f, --filter <state>', 'Show only teammates in this state: running, completed, failed, stopped, or all (default: all)', 'all')
         .option('-s, --since <iso>', 'Cursor from a previous status call; only show updates after this timestamp (enables efficient polling)')
         .option('--agent-id <id>', 'Show only this one teammate (by UUID or UUID prefix)')
         .option('--json', 'Output machine-readable JSON')
         .action(async (team, opts) => {
-        // Map friendly 'working' → internal 'running' for filter.
-        const filter = opts.filter === 'working' ? 'running' : opts.filter;
+        const filter = opts.filter;
         const mgr = mkManager();
         // No team given → drop into the picker (TTY) or fail clearly (script).
         if (!team) {

package/dist/commands/usage.js

@@ -8,6 +8,12 @@ export function registerUsageCommand(program) {
     program
         .command('usage [agent]')
         .description('Show rate-limit / quota usage per agent')
+        .addHelpText('after', `
+Examples:
+  agents usage              Show usage for all installed agents
+  agents usage claude       Show usage for Claude only
+  agents usage codex        Show usage for Codex only
+`)
         .action(async (agentFilter) => {
         const filter = agentFilter;
         const targets = filter

package/dist/commands/utils.d.ts

@@ -38,6 +38,22 @@ export declare function printWithPager(output: string, lineCount: number): void;
  * Parse a comma-separated CLI list, trimming whitespace and dropping empties.
  */
 export declare function parseCommaSeparatedList(value: string | undefined): string[];
+/**
+ * A target for resource removal: agent + version.
+ */
+export interface RemovalTarget {
+    agent: string;
+    version: string;
+    label: string;
+}
+/**
+ * Prompt user to select which agent/version targets to remove a resource from.
+ * If only one target, returns it without prompting. If multiple, shows checkbox.
+ * Returns empty array if user cancels or selects nothing.
+ */
+export declare function promptRemovalTargets(resourceName: string, targets: RemovalTarget[], options?: {
+    skipPrompt?: boolean;
+}): Promise<RemovalTarget[]>;
 /**
  * Format a path for display, using ~ for home directory
  */

package/dist/commands/utils.js

@@ -89,6 +89,38 @@ export function parseCommaSeparatedList(value) {
         .map((item) => item.trim())
         .filter(Boolean);
 }
+/**
+ * Prompt user to select which agent/version targets to remove a resource from.
+ * If only one target, returns it without prompting. If multiple, shows checkbox.
+ * Returns empty array if user cancels or selects nothing.
+ */
+export async function promptRemovalTargets(resourceName, targets, options) {
+    if (targets.length === 0)
+        return [];
+    if (targets.length === 1 || options?.skipPrompt)
+        return targets;
+    if (!isInteractiveTerminal()) {
+        return targets;
+    }
+    const { checkbox } = await import('@inquirer/prompts');
+    try {
+        const selected = await checkbox({
+            message: `Select targets to remove '${resourceName}' from`,
+            choices: targets.map((t) => ({
+                value: t,
+                name: t.label,
+                checked: true,
+            })),
+        });
+        return selected;
+    }
+    catch (err) {
+        if (isPromptCancelled(err)) {
+            return [];
+        }
+        throw err;
+    }
+}
 /**
  * Format a path for display, using ~ for home directory
  */

package/dist/commands/versions.js

@@ -104,7 +104,7 @@ When to use:
   - Multi-account: install different versions for different accounts (each version has its own auth)
   - Project-specific: lock a version for a repo with --project
 
-Note: The first version you install is NOT set as default automatically. Run 'agents use' to set it.
+Note: The first version you install becomes the default automatically.
 `)
         .action(async (specs, options) => {
         const isProject = options.project;
@@ -220,10 +220,14 @@ Note: The first version you install is NOT set as default automatically. Run 'ag
                             console.log(chalk.green(`  Synced: ${synced.join(', ')}`));
                         }
                     }
-                    // Prompt to set as default
+                    // Set as default: auto-set if no default exists, otherwise prompt
                     const currentDefault = getGlobalDefault(agent);
                     if (currentDefault !== installedVersion) {
-                        if (skipPrompts) {
+                        if (!currentDefault) {
+                            // First install for this agent - auto-set without prompting
+                            await setDefaultVersion(agent, installedVersion);
+                        }
+                        else if (skipPrompts) {
                             await setDefaultVersion(agent, installedVersion);
                         }
                         else {
@@ -238,9 +242,7 @@ Note: The first version you install is NOT set as default automatically. Run 'ag
                                     info,
                                 });
                                 const accountHint = formatAccountHint(info, usage.snapshot);
-                                const message = currentDefault
-                                    ? `Switch default from ${agentLabel(agentConfig.id)}@${currentDefault} to ${agentLabel(agentConfig.id)}@${installedVersion}${accountHint}?`
-                                    : `Set ${agentLabel(agentConfig.id)}@${installedVersion}${accountHint} as default?`;
+                                const message = `Switch default from ${agentLabel(agentConfig.id)}@${currentDefault} to ${agentLabel(agentConfig.id)}@${installedVersion}${accountHint}?`;
                                 const setAsDefault = await confirm({
                                     message,
                                     default: true,

package/dist/commands/view.js

@@ -2,16 +2,16 @@ import chalk from 'chalk';
 import ora from 'ora';
 import * as fs from 'fs';
 import * as path from 'path';
-import * as yaml from 'yaml';
 import { AGENTS, ALL_AGENT_IDS, getAllCliStates, getAccountInfo, resolveAgentName, formatAgentError, agentLabel, colorAgent, } from '../lib/agents.js';
 import { formatUsageSection, formatUsageSummary, getUsageInfoForIdentity, getUsageInfoByIdentity, getUsageLookupKey, } from '../lib/usage.js';
 import { readManifest } from '../lib/manifest.js';
 import { listInstalledVersions, listInstalledVersionDirs, getGlobalDefault, getVersionHomePath, getVersionDir, resolveVersionAlias, getAvailableResources, getActuallySyncedResources, getNewResources, hasNewResources, promptNewResourceSelection, syncResourcesToVersion, removeVersion, } from '../lib/versions.js';
 import { getShimsDir, isShimsInPath, ensureVersionedAliasCurrent, removeShim, } from '../lib/shims.js';
 import { getAgentResources } from '../lib/resources.js';
-import { getAgentsDir, getUserAgentsDir, getPromptcutsPath } from '../lib/state.js';
+import { getAgentsDir, getUserAgentsDir, getEffectivePromptcutsPath, readMergedPromptcuts } from '../lib/state.js';
 import { isGitRepo, getGitSyncStatus } from '../lib/git.js';
 import { getCentralRulesFileName } from '../lib/rules/rules.js';
+import { composeRulesFromState } from '../lib/rules/compose.js';
 import { getConfiguredRunStrategy } from '../lib/rotate.js';
 import { confirm } from '@inquirer/prompts';
 import { formatPath, isInteractiveTerminal, isPromptCancelled } from './utils.js';
@@ -512,25 +512,19 @@ async function showAgentResources(agentId, requestedVersion) {
             console.log(`    ${display.padEnd(38)} ${pathStr}${syncStr}`);
         }
     }
-    // Render the single ~/.agents/promptcuts.yaml (cross-agent, not per-version).
-    // Reads the file to surface the shortcut count — cheap (<1KB typical).
+    // Render promptcuts (cross-agent, not per-version). Shortcuts are layered
+    // across system + user files with user precedence; the displayed file path
+    // is whichever is "live" — user if it exists, else system.
     function renderPromptcuts() {
         console.log(chalk.bold(`\nPromptcuts\n`));
-        const promptcutsPath = getPromptcutsPath();
-        if (!fs.existsSync(promptcutsPath)) {
+        const merged = readMergedPromptcuts();
+        const count = Object.keys(merged).length;
+        if (count === 0) {
             console.log(`  ${chalk.gray('none')}`);
             return;
         }
-        let count = 0;
-        try {
-            const parsed = yaml.parse(fs.readFileSync(promptcutsPath, 'utf-8'));
-            count = parsed?.shortcuts ? Object.keys(parsed.shortcuts).length : 0;
-        }
-        catch {
-            count = 0;
-        }
         const label = `${count} shortcut${count === 1 ? '' : 's'}`;
-        console.log(`  ${chalk.green(label).padEnd(24)} ${chalk.gray(formatPath(promptcutsPath, cwd))}`);
+        console.log(`  ${chalk.green(label).padEnd(24)} ${chalk.gray(formatPath(getEffectivePromptcutsPath(), cwd))}`);
     }
     // 1. Agent CLI info
     console.log(chalk.bold('Agent CLIs\n'));
@@ -565,7 +559,58 @@ async function showAgentResources(agentId, requestedVersion) {
         }
     }
     renderSection('MCP Servers', agentData.mcp);
-    renderSection('Rules', agentData.memory);
+    // Rules section with subrules breakdown
+    function renderRulesSection() {
+        console.log(chalk.bold('\nRules\n'));
+        const items = agentData.memory;
+        if (items.length === 0) {
+            console.log(`  ${chalk.gray('none')}`);
+            return;
+        }
+        const versionStr = agentData.version ? ` (${agentData.version})` : '';
+        console.log(`  ${chalk.bold(agentData.agentName)}${chalk.gray(versionStr)}:`);
+        // Get composed subrules for the user scope
+        let composedSubrules = [];
+        try {
+            const composed = composeRulesFromState({ cwd });
+            composedSubrules = composed.subrules;
+        }
+        catch {
+            // No preset configured or rules.yaml missing — show rules without subrule breakdown
+        }
+        for (const r of items) {
+            let nameColor = chalk.cyan;
+            if (r.syncState === 'synced')
+                nameColor = chalk.green;
+            else if (r.syncState === 'new')
+                nameColor = chalk.blue;
+            else if (r.syncState === 'modified')
+                nameColor = chalk.yellow;
+            else if (r.syncState === 'deleted')
+                nameColor = chalk.red;
+            let display = nameColor(r.name);
+            if (r.ruleCount !== undefined)
+                display += chalk.gray(` (${r.ruleCount} rules)`);
+            const sourceTag = r.scope === 'project' ? chalk.blue('[project]')
+                : r.scope === 'user' ? chalk.cyan('[user]')
+                    : chalk.gray('[system]');
+            display += ` ${sourceTag}`;
+            const pathStr = r.path ? chalk.gray(formatPath(r.path, cwd)) : '';
+            const syncStr = r.syncState ? chalk.gray(` [${r.syncState}]`) : '';
+            console.log(`    ${display.padEnd(38)} ${pathStr}${syncStr}`);
+            // Show subrules for user-scope rules (the compiled CLAUDE.md)
+            if (r.scope === 'user' && composedSubrules.length > 0) {
+                for (const sub of composedSubrules) {
+                    const scopeLabel = sub.layerScope === 'project' ? chalk.blue('[project]')
+                        : sub.layerScope === 'user' ? chalk.cyan('[user]')
+                            : sub.layerScope === 'extra' ? chalk.magenta(`[${sub.layerAlias || 'extra'}]`)
+                                : chalk.gray('[system]');
+                    console.log(`      ${chalk.gray('-')} ${sub.name} ${scopeLabel}`);
+                }
+            }
+        }
+    }
+    renderRulesSection();
     renderSection('Hooks', agentData.hooks);
     renderPromptcuts();
     // Show legend at the end if git repo exists

package/dist/index.d.ts

@@ -3,6 +3,6 @@
  * CLI entry point for agents-cli.
  *
  * Registers all commands, handles update checks, auto-corrects typos,
- * and launches the first-run interactive init when appropriate.
+ * and launches the first-run interactive setup when appropriate.
  */
 export {};