@phnx-labs/agents-cli 1.20.5 → 1.20.7

package/dist/commands/sessions.js

@@ -15,6 +15,7 @@ import chalk from 'chalk';
 import ora from 'ora';
 import { SESSION_AGENTS } from '../lib/session/types.js';
 import { discoverArtifacts, readArtifact, resolveArtifact } from '../lib/session/artifacts.js';
+import { looksLikePath, toComparablePath, homeDir } from '../lib/platform/index.js';
 import { getActiveSessions } from '../lib/session/active.js';
 import { discoverSessions, countSessionsInScope, resolveSessionById, searchContentIndex } from '../lib/session/discover.js';
 import { filterTeamSessions } from '../lib/session/team-filter.js';
@@ -69,15 +70,6 @@ function createScanProgressTracker(verbs, suffix, spinner) {
 }
 const PICKER_RECENT_COUNT = 15;
 const PICKER_POOL_LIMIT = 200;
-/**
- * Detect whether a positional argument looks like a filesystem path.
- * Naked paths (., ./, ../, /, ~) filter sessions by project directory.
- * Everything else is treated as a search query string.
- */
-function isPathLike(query) {
-    return query === '.' || query.startsWith('./') || query.startsWith('../')
-        || query.startsWith('/') || query.startsWith('~');
-}
 /**
  * Resolve a path-like query to an absolute directory path.
  */
@@ -153,8 +145,13 @@ function contextColor(context) {
 function shortCwd(cwd) {
     if (!cwd)
         return '-';
-    const home = os.homedir();
-    return cwd.startsWith(home) ? '~' + cwd.slice(home.length) : cwd;
+    const home = homeDir();
+    // Compare in normalized form so the `~` shorthand also lands on Windows
+    // (case-insensitive, backslash paths); on POSIX this is byte-identical to the
+    // previous `cwd.startsWith(home)`. The displayed tail keeps original casing.
+    return toComparablePath(cwd).startsWith(toComparablePath(home))
+        ? '~' + cwd.slice(home.length)
+        : cwd;
 }
 function formatStartedAt(startedAtMs) {
     if (!startedAtMs)
@@ -334,7 +331,7 @@ async function sessionsAction(query, options) {
     // Path-like queries filter by project directory instead of text search.
     let pathFilter;
     let searchQuery;
-    if (query && isPathLike(query)) {
+    if (query && looksLikePath(query)) {
         const resolved = resolvePathFilter(query);
         if (!fs.existsSync(resolved)) {
             console.log(chalk.yellow(`Path not found: ${resolved}`));

package/dist/commands/setup.js

@@ -14,7 +14,7 @@ import { DEFAULT_SYSTEM_REPO, systemRepoSlug } from '../lib/types.js';
 import { getAgentsDir, getVersionsDir, ensureAgentsDir } from '../lib/state.js';
 import { isGitRepo, cloneIntoExisting, pullRepo } from '../lib/git.js';
 import { isPromptCancelled, isInteractiveTerminal } from './utils.js';
-import { AGENTS, getUnmanagedAgentInstalls, countSessionFiles, agentLabel } from '../lib/agents.js';
+import { AGENTS, agentConfigDirName, getUnmanagedAgentInstalls, countSessionFiles, agentLabel } from '../lib/agents.js';
 import { setGlobalDefault } from '../lib/versions.js';
 import { ensureShimCurrent, switchHomeFileSymlinks, isShimsInPath, addShimsToPath, getPathSetupInstructions } from '../lib/shims.js';
 import { setHelpSections } from '../lib/help.js';
@@ -28,7 +28,7 @@ async function importAgent(agentId, version) {
     const configDir = agent.configDir;
     const versionsDir = getVersionsDir();
     const versionHome = path.join(versionsDir, agentId, version, 'home');
-    const versionConfigDir = path.join(versionHome, `.${agentId}`);
+    const versionConfigDir = path.join(versionHome, agentConfigDirName(agentId));
     // Skip if version dir already exists (collision)
     if (fs.existsSync(versionConfigDir)) {
         return { success: false, skipped: true, error: `${version} already installed` };

package/dist/commands/teams.js

@@ -4,7 +4,7 @@ import * as path from 'path';
 import { AgentManager, checkAllClis, getAgentsDir, VALID_TASK_TYPES, } from '../lib/teams/agents.js';
 import { resolveProvider } from '../lib/cloud/registry.js';
 import { runSupervisor } from '../lib/teams/supervisor.js';
-import { handleSpawn, handleStatus, handleStop, handleTasks, } from '../lib/teams/api.js';
+import { handleSpawn, handleStatus, handleStop, handleTasks, toTaskStatusSummary, } from '../lib/teams/api.js';
 import { createTeam, ensureTeam, getTeam, loadTeams, removeTeam, teamExists, } from '../lib/teams/registry.js';
 import { setHelpSections } from '../lib/help.js';
 import { createWorktree, isGitRepo, hasUncommittedChanges, removeWorktree, } from '../lib/teams/worktree.js';
@@ -382,6 +382,55 @@ async function resolveTeammateSessions(agents) {
     }
     return map;
 }
+// Default compact renderer — one block per teammate, optimized for the
+// orchestrator scanning "what state, what did you touch, what did you say
+// last." Caller passes the projected AgentStatusSummary; for the full
+// verbose layout use printAgentDetail above.
+function printAgentSummary(s) {
+    const label = statusColor(s.status)(s.status.toUpperCase());
+    const handle = s.name ?? shortId(s.agent_id);
+    const ident = s.name ? chalk.gray(`(${shortId(s.agent_id)})`) : '';
+    const duration = s.duration ? `${chalk.gray(' · ')}${chalk.white(s.duration)}` : '';
+    const errBadge = s.has_errors ? chalk.red(' !') : '';
+    const tools = chalk.gray(` · ${s.tool_count} tools`);
+    console.log(`  ${chalk.cyan(handle.padEnd(14))} ${ident.padEnd(11)} ${label}${duration}${tools}${errBadge}`);
+    // Files: counts + basenames. Read is count only.
+    const fileLines = [];
+    const renderCat = (label, cat) => {
+        if (cat.count === 0)
+            return;
+        const more = cat.count > cat.names.length ? ` +${cat.count - cat.names.length}` : '';
+        const names = cat.names.length ? ` ${cat.names.join(', ')}${more}` : '';
+        fileLines.push(`${label} ${cat.count}${names}`);
+    };
+    renderCat('modified', s.files.modified);
+    renderCat('created', s.files.created);
+    renderCat('deleted', s.files.deleted);
+    if (s.files.read.count > 0)
+        fileLines.push(`read ${s.files.read.count}`);
+    if (fileLines.length) {
+        console.log(`    ${chalk.gray('files   ')} ${fileLines.join(chalk.gray(' · '))}`);
+    }
+    // Last 3 bash commands.
+    const recentBash = s.bash_commands.slice(-3);
+    if (recentBash.length) {
+        console.log(`    ${chalk.gray('bash    ')}`);
+        for (const cmd of recentBash) {
+            console.log(`      ${chalk.gray('$')} ${truncate(cmd, 96)}`);
+        }
+    }
+    // Last messages — first non-empty line of each, truncated.
+    if (s.last_messages.length) {
+        console.log(`    ${chalk.gray('messages')}`);
+        for (const msg of s.last_messages) {
+            const firstLine = msg.split(/\r?\n/).find((l) => l.trim()) || '';
+            if (firstLine)
+                console.log(`      ${chalk.gray('>')} ${truncate(firstLine, 96)}`);
+        }
+    }
+    if (s.pr_url)
+        console.log(`    ${chalk.gray('PR      ')} ${chalk.cyan(s.pr_url)}`);
+}
 // Render a team's status in the same format the `status` subcommand uses, so
 // the interactive picker's Enter action drops the user into a familiar view.
 async function printTeamStatus(team, result) {
@@ -409,6 +458,36 @@ async function printTeamStatus(team, result) {
     console.log();
     console.log(chalk.gray(`cursor: ${result.cursor}`));
 }
+// Compact default renderer — no session-file dive, no per-teammate
+// 15-line preview. One block per teammate, suitable for the orchestrator
+// scanning what each agent did. Use `printTeamStatus` (above) for the
+// verbose/legacy layout.
+function printTeamSummary(team, result) {
+    const { summary, agents } = result;
+    console.log(chalk.bold(`Team ${chalk.cyan(team)}  `) +
+        chalk.gray(summary.pending > 0
+            ? `(${summary.pending} pending, ${summary.running} working, ${summary.completed} done, ${summary.failed} failed, ${summary.stopped} stopped)`
+            : `(${summary.running} working, ${summary.completed} done, ${summary.failed} failed, ${summary.stopped} stopped)`));
+    if (agents.length === 0) {
+        console.log(chalk.gray('  (no teammates yet — add one with `agents teams add`)'));
+    }
+    else {
+        const width = Math.min(process.stdout.columns || 80, 80);
+        const divider = chalk.gray('┈'.repeat(width));
+        for (let i = 0; i < agents.length; i++) {
+            console.log();
+            if (i > 0) {
+                console.log(divider);
+                console.log();
+            }
+            printAgentSummary(agents[i]);
+        }
+    }
+    console.log();
+    console.log(chalk.gray(`cursor: ${result.cursor}`));
+    console.log(chalk.gray('Full detail: agents teams status ' + team + ' --verbose'));
+    console.log(chalk.gray('Raw log:     agents teams logs --team ' + team + ' --teammate <name>'));
+}
 // Classify a team into a single bucket for --status filtering.
 //  - empty:   no teammates (created but nobody added yet)
 //  - waiting: only staged teammates — call `teams start` to kick them off
@@ -964,10 +1043,11 @@ export function registerTeamsCommands(program) {
     teams
         .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.")
+        .description("Check in on a team: status, files touched, recent commands, last messages. Pass --verbose for the full per-teammate dump; --since for delta polling.")
         .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('-v, --verbose', 'Emit the full per-teammate detail (prompt, all file paths, all messages). Default is a compact summary.')
         .option('--json', 'Output machine-readable JSON')
         .action(async (team, opts) => {
         const filter = opts.filter;
@@ -984,8 +1064,15 @@ export function registerTeamsCommands(program) {
             const agents = opts.agentId
                 ? result.agents.filter((a) => a.agent_id.startsWith(opts.agentId))
                 : result.agents;
+            const filtered = { ...result, agents };
             if (isJsonMode(opts)) {
-                console.log(JSON.stringify({ ...result, agents }, null, 2));
+                // JSON output also respects --verbose. Default = compact summary
+                // shape; --verbose = full AgentStatusDetail. Same toggle covers
+                // both text and JSON so MCP-style consumers can opt into detail.
+                const payload = opts.verbose
+                    ? filtered
+                    : toTaskStatusSummary(filtered);
+                console.log(JSON.stringify(payload, null, 2));
                 return;
             }
             const exists = await teamExists(team);
@@ -993,7 +1080,12 @@ export function registerTeamsCommands(program) {
                 console.log(chalk.yellow(`No team called '${team}'. Create it with: agents teams create ${team}`));
                 return;
             }
-            await printTeamStatus(team, { ...result, agents });
+            if (opts.verbose) {
+                await printTeamStatus(team, filtered);
+            }
+            else {
+                printTeamSummary(team, toTaskStatusSummary(filtered));
+            }
         }
         catch (err) {
             die(`Could not check on team ${team}: ${err.message}`);
@@ -1308,14 +1400,19 @@ export function registerTeamsCommands(program) {
     teams
         .command('logs [teammate]')
         .alias('log')
-        .description("Read a teammate's raw log output. Accepts name, UUID, or UUID prefix.")
+        .description("Read a teammate's raw log output. Accepts positional name, --teammate <name>, UUID, or UUID prefix.")
         .option('-n, --tail <n>', 'Show only the last N lines instead of the full log')
         .option('--team <team>', 'Disambiguate when the same name appears in multiple teams')
+        .option('--teammate <name>', 'Teammate name (alias for the positional arg; useful for scripts)')
         .action(async (ref, opts) => {
         const base = await getAgentsDir();
-        // No teammate → picker in TTY, hard fail outside.
+        // Resolve teammate identity. Precedence:
+        //   1. positional `[teammate]` arg (back-compat, most common)
+        //   2. --teammate <name> flag (script-friendly alias)
+        //   3. interactive picker (TTY only)
+        const teammateRef = ref ?? opts.teammate;
         let agentId;
-        if (!ref) {
+        if (!teammateRef) {
             const mgr = mkManager();
             const picked = await pickTeammateOr(mgr, 'agents teams logs');
             if (!picked)
@@ -1323,13 +1420,13 @@ export function registerTeamsCommands(program) {
             agentId = picked.agentId;
         }
         else {
-            const resolved = await resolveTeammateAcrossTeams(base, ref, opts.team);
+            const resolved = await resolveTeammateAcrossTeams(base, teammateRef, opts.team);
             if (resolved.kind === 'none') {
-                die(`No notes on record for teammate '${ref}'`, 2);
+                die(`No notes on record for teammate '${teammateRef}'`, 2);
             }
             if (resolved.kind === 'ambiguous') {
                 const hints = resolved.candidates.map((c) => `${c.team}/${c.display}`).join(', ');
-                die(`'${ref}' matches multiple teammates: ${hints}.\n` +
+                die(`'${teammateRef}' matches multiple teammates: ${hints}.\n` +
                     `  Narrow it with --team <team>, or pass a UUID prefix.`, 2);
             }
             agentId = resolved.agentId;
@@ -1346,7 +1443,7 @@ export function registerTeamsCommands(program) {
             process.stdout.write(lines.slice(-n).join('\n'));
         }
         catch {
-            die(`No notes on record for teammate '${ref ?? agentId}' (looked in ${logPath})`, 2);
+            die(`No notes on record for teammate '${teammateRef ?? agentId}' (looked in ${logPath})`, 2);
         }
     });
     // doctor

package/dist/commands/view.d.ts

@@ -9,6 +9,17 @@
 import type { Command } from 'commander';
 import type { AgentId } from '../lib/types.js';
 import { type ProfileSummary } from '../lib/profiles.js';
+/** Per-section filter flags. When any are true, only those sections render. */
+export interface ViewSectionFilter {
+    commands?: boolean;
+    skills?: boolean;
+    mcp?: boolean;
+    workflows?: boolean;
+    plugins?: boolean;
+    rules?: boolean;
+    hooks?: boolean;
+    promptcuts?: boolean;
+}
 /** Machine-readable entry for a single installed version. */
 export interface ViewJsonVersion {
     version: string;
@@ -54,6 +65,6 @@ export declare function viewAction(agentArg?: string, options?: {
     prune?: boolean;
     yes?: boolean;
     dryRun?: boolean;
-}): Promise<void>;
+} & ViewSectionFilter): Promise<void>;
 /** Register the `agents view` command. */
 export declare function registerViewCommand(program: Command): void;

package/dist/commands/view.js

@@ -15,6 +15,7 @@ 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 { resolveRunDefaults } from '../lib/run-defaults.js';
 import { listProfiles, profileSummary } from '../lib/profiles.js';
 import { loadManifest, isStale } from '../lib/staleness/index.js';
 import { confirm } from '@inquirer/prompts';
@@ -113,6 +114,29 @@ function getProjectVersionFromCwd(agent) {
         return null;
     }
 }
+const SECTION_KEYS = ['commands', 'skills', 'mcp', 'workflows', 'plugins', 'rules', 'hooks', 'promptcuts'];
+/**
+ * Decide whether a section should render given the filter. If no flags are set,
+ * everything renders (current behavior). If any flag is set, only those sections
+ * render — flags are additive.
+ */
+function shouldRenderSection(key, filter) {
+    if (!filter)
+        return true;
+    const anySet = SECTION_KEYS.some((k) => filter[k]);
+    if (!anySet)
+        return true;
+    return filter[key] === true;
+}
+/** Trim a description to a column-friendly snippet. Strips newlines, collapses whitespace. */
+function summarizeDescription(desc, maxLen = 80) {
+    if (!desc)
+        return '';
+    const cleaned = desc.replace(/\s+/g, ' ').trim();
+    if (cleaned.length <= maxLen)
+        return cleaned;
+    return cleaned.slice(0, maxLen - 1).trimEnd() + '…';
+}
 function getProfileSummaries(filterAgentId) {
     return listProfiles()
         .filter((profile) => !filterAgentId || profile.host.agent === filterAgentId)
@@ -338,6 +362,12 @@ async function showInstalledVersions(filterAgentId) {
                 // Otherwise it reflects install time (misleading "just now" for fresh installs).
                 const activeStr = vInfo && hasEmail ? formatLastActive(vInfo.lastActive) : '';
                 const hasActive = activeStr.length > 0;
+                const runDefaults = resolveRunDefaults(agentId, version);
+                const runDefaultBits = [];
+                if (runDefaults.mode)
+                    runDefaultBits.push(`mode:${runDefaults.mode}`);
+                if (runDefaults.model)
+                    runDefaultBits.push(`model:${runDefaults.model}`);
                 if (!hasEmail && !hasUsage) {
                     // Installed but never signed in
                     parts.push(chalk.gray('(not signed in — run ' + agent.cliCommand + ' to log in)'));
@@ -359,6 +389,9 @@ async function showInstalledVersions(filterAgentId) {
                     if (hasActive)
                         parts.push(activeStr);
                 }
+                if (runDefaultBits.length > 0) {
+                    parts.push(chalk.gray(`run ${runDefaultBits.join(' ')}`));
+                }
                 console.log(parts.join('  '));
                 if (showPaths) {
                     const versionDir = getVersionDir(agentId, version);
@@ -568,7 +601,7 @@ async function showInstalledVersions(filterAgentId) {
  * Show detailed resources for a specific agent version.
  * Called when: `agents view claude@2.0.65` or `agents view claude@default`
  */
-async function showAgentResources(agentId, requestedVersion) {
+async function showAgentResources(agentId, requestedVersion, filter) {
     const spinner = ora({ text: 'Loading...', isSilent: !process.stdout.isTTY }).start();
     const cwd = process.cwd();
     const agentsDir = getAgentsDir();
@@ -660,6 +693,8 @@ async function showAgentResources(agentId, requestedVersion) {
         })),
         skills: resources.skills.map(r => ({
             ...r,
+            // ruleCount of 0 is noise — every skill has 0 unless it ships subrules, which is rare.
+            ruleCount: r.ruleCount && r.ruleCount > 0 ? r.ruleCount : undefined,
             syncState: r.scope === 'project' ? undefined : getSyncState(r.name, 'skills', skillsSync),
         })),
         skillErrors: resources.skillErrors,
@@ -705,7 +740,9 @@ async function showAgentResources(agentId, requestedVersion) {
                     : chalk.gray('[system]');
             display += ` ${sourceTag}`;
             const syncStr = r.syncState ? chalk.gray(` [${r.syncState}]`) : '';
-            console.log(`    ${display}${syncStr}`);
+            const descSnippet = summarizeDescription(r.description);
+            const descStr = descSnippet ? chalk.gray(`  ${descSnippet}`) : '';
+            console.log(`    ${display}${syncStr}${descStr}`);
         }
     }
     // Render promptcuts (cross-agent, not per-version). Shortcuts are layered
@@ -722,43 +759,53 @@ async function showAgentResources(agentId, requestedVersion) {
         const label = `${count} shortcut${count === 1 ? '' : 's'}`;
         console.log(`  ${chalk.green(label).padEnd(24)} ${chalk.gray(formatPath(getEffectivePromptcutsPath(), cwd))}`);
     }
-    // 1. Agent CLI info
-    console.log(chalk.bold('Agent CLIs\n'));
-    const accountInfo = await getAccountInfo(agentId, home);
-    const usageInfo = await getUsageInfoForIdentity({
-        agentId,
-        home,
-        cliVersion: version,
-        info: accountInfo,
-    });
-    const emailStr = accountInfo.email ? chalk.cyan(`  ${accountInfo.email}`) : '';
-    const status = chalk.green(version);
-    const usageStr = formatUsageSummary(accountInfo.plan, null);
-    const usagePart = usageStr ? `  ${usageStr}` : '';
-    console.log(`  ${colorAgent(agentId)(AGENTS[agentId].name.padEnd(14))} ${status}${emailStr}${usagePart}`);
-    const usageLines = formatUsageSection(usageInfo);
-    if (usageLines.length > 0) {
-        console.log();
-        for (const line of usageLines) {
-            console.log(line);
+    const anyFilterSet = filter && SECTION_KEYS.some((k) => filter[k]);
+    // 1. Agent CLI info — skip the header entirely when the user asked for a
+    // specific section. They want "nothing more or less."
+    if (!anyFilterSet) {
+        console.log(chalk.bold('Agent CLIs\n'));
+        const accountInfo = await getAccountInfo(agentId, home);
+        const usageInfo = await getUsageInfoForIdentity({
+            agentId,
+            home,
+            cliVersion: version,
+            info: accountInfo,
+        });
+        const emailStr = accountInfo.email ? chalk.cyan(`  ${accountInfo.email}`) : '';
+        const status = chalk.green(version);
+        const usageStr = formatUsageSummary(accountInfo.plan, null);
+        const usagePart = usageStr ? `  ${usageStr}` : '';
+        console.log(`  ${colorAgent(agentId)(AGENTS[agentId].name.padEnd(14))} ${status}${emailStr}${usagePart}`);
+        const usageLines = formatUsageSection(usageInfo);
+        if (usageLines.length > 0) {
+            console.log();
+            for (const line of usageLines) {
+                console.log(line);
+            }
         }
     }
     // 2. Resources
-    renderSection('Commands', agentData.commands);
-    renderSection('Skills', agentData.skills);
-    // Show skill parse errors if any
-    if (agentData.skillErrors.length > 0) {
-        console.log(`\n  ${chalk.red('Skill Errors')}:`);
-        for (const err of agentData.skillErrors) {
-            console.log(`    ${chalk.red(err.name.padEnd(20))} ${chalk.gray(err.error)}`);
-            console.log(`      ${chalk.gray(formatPath(err.path, cwd))}`);
+    if (shouldRenderSection('commands', filter)) {
+        renderSection('Commands', agentData.commands);
+    }
+    if (shouldRenderSection('skills', filter)) {
+        renderSection('Skills', agentData.skills);
+        // Show skill parse errors only when skills section is visible
+        if (agentData.skillErrors.length > 0) {
+            console.log(`\n  ${chalk.red('Skill Errors')}:`);
+            for (const err of agentData.skillErrors) {
+                console.log(`    ${chalk.red(err.name.padEnd(20))} ${chalk.gray(err.error)}`);
+                console.log(`      ${chalk.gray(formatPath(err.path, cwd))}`);
+            }
         }
     }
-    renderSection('MCP Servers', agentData.mcp);
-    if (isCapable(agentId, 'workflows')) {
+    if (shouldRenderSection('mcp', filter)) {
+        renderSection('MCP Servers', agentData.mcp);
+    }
+    if (shouldRenderSection('workflows', filter) && isCapable(agentId, 'workflows')) {
         renderSection('Workflows', agentData.workflows);
     }
-    if (isCapable(agentId, 'plugins')) {
+    if (shouldRenderSection('plugins', filter) && isCapable(agentId, 'plugins')) {
         const plugins = discoverPlugins().filter(p => pluginSupportsAgent(p, agentId));
         console.log(chalk.bold('\nPlugins\n'));
         if (plugins.length === 0) {
@@ -847,11 +894,18 @@ async function showAgentResources(agentId, requestedVersion) {
             }
         }
     }
-    renderRulesSection();
-    renderSection('Hooks', agentData.hooks);
-    renderPromptcuts();
-    // Show legend at the end if git repo exists
-    if (hasGitRepo) {
+    if (shouldRenderSection('rules', filter)) {
+        renderRulesSection();
+    }
+    if (shouldRenderSection('hooks', filter)) {
+        renderSection('Hooks', agentData.hooks);
+    }
+    if (shouldRenderSection('promptcuts', filter)) {
+        renderPromptcuts();
+    }
+    // Show legend at the end if git repo exists and we showed all sections.
+    // Filtered single-section views skip it — noise for promptcuts or plugins.
+    if (hasGitRepo && !anyFilterSet) {
         console.log();
         console.log(chalk.gray('Legend:'), chalk.green('Tracked'), chalk.blue('Local-only'), chalk.yellow('Modified'), chalk.red('Deleted'));
     }
@@ -1131,6 +1185,17 @@ export async function viewAction(agentArg, options) {
     const prune = options?.prune === true;
     const yes = options?.yes === true;
     const dryRun = options?.dryRun === true;
+    const filter = {
+        commands: options?.commands,
+        skills: options?.skills,
+        mcp: options?.mcp,
+        workflows: options?.workflows,
+        plugins: options?.plugins,
+        rules: options?.rules,
+        hooks: options?.hooks,
+        promptcuts: options?.promptcuts,
+    };
+    const filterIsSet = SECTION_KEYS.some((k) => filter[k]);
     if (!agentArg) {
         if (prune) {
             await pruneDuplicates(undefined, yes, dryRun);
@@ -1180,7 +1245,12 @@ export async function viewAction(agentArg, options) {
     }
     if (requestedVersion) {
         // Specific version requested: show detailed resources
-        await showAgentResources(agentId, requestedVersion);
+        await showAgentResources(agentId, requestedVersion, filter);
+    }
+    else if (filterIsSet) {
+        // `agents view claude --skills` → fall through to detail view on default.
+        // Section filters only make sense for the per-version detail view.
+        await showAgentResources(agentId, 'default', filter);
     }
     else {
         // Just agent name: show versions for that agent
@@ -1196,6 +1266,14 @@ export function registerViewCommand(program) {
         .option('--prune', 'Remove older installed versions that share an account with a newer installed version. Skips the global default.')
         .option('--dry-run', 'With --prune, show duplicate versions without deleting')
         .option('-y, --yes', 'Skip the prune confirmation prompt.')
+        .option('--commands', 'Show only commands in the detail view.')
+        .option('--skills', 'Show only skills in the detail view.')
+        .option('--mcp', 'Show only MCP servers in the detail view.')
+        .option('--workflows', 'Show only workflows in the detail view.')
+        .option('--plugins', 'Show only plugins in the detail view.')
+        .option('--rules', 'Show only rules in the detail view.')
+        .option('--hooks', 'Show only hooks in the detail view.')
+        .option('--promptcuts', 'Show only promptcuts in the detail view.')
         .addHelpText('after', `
 Examples:
   # Show all installed agents with versions, accounts, and usage
@@ -1216,6 +1294,11 @@ Examples:
   agents view claude --prune
   agents view claude --prune -y
 
+  # Filter the detail view to a single section (combinable)
+  agents view claude@default --skills
+  agents view claude@default --plugins --workflows
+  agents view claude --commands    # implicitly the default version
+
 When to use:
   - Checking which agents are installed and what their default versions are
   - Seeing which account each version is logged into (useful for multi-account setups)