@phnx-labs/agents-cli 1.20.9 → 1.20.10

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+**`agents inspect .` reads the project `.agents/`, and plugin drill-down shows bundled skills**
+
+- `agents inspect .` (and any path to a repo root) now resolves to the project's nested `.agents/` tree when that tree is a populated DotAgents root, instead of the project root itself. Previously a top-level `agents.yaml` version-pin or an unrelated source `skills/` dir at the repo root was mistaken for a DotAgents root, so `inspect .` reported the wrong directory's resources (e.g. `plugins 0` while the real `.agents/plugins/` held a plugin). A bare `.agents`-named dir still resolves to itself, and standalone clones / extra repos that keep resources at the top level (using `.agents/` only for worktrees) are unaffected — their nested `.agents/` is not a DotAgents root, so the top level still wins.
+- `agents inspect <repo> --plugins` now reads plugin bundles through the plugin discoverer: the list shows each plugin's manifest description, and drilling into one (`--plugins <name>`) reports its bundled skills, commands, subagents, hooks, MCP servers, and version. Previously plugins were treated as opaque directories with no description and no view into what they ship.
+
 **Single-typo agent names auto-correct everywhere, not just `agents run`**
 
 - `agents view cladue` used to print `Unknown agent 'cladue'` even though `agents run cladue` auto-corrected. `resolveAgentName` — the canonical resolver behind `view`, `usage`, `inspect`, `doctor`, `sync`, `models`, `skills`, `hooks`, `import`, `sessions --agent`, and every `agent@version` spec (`agents add claud@latest`, `agents use codx@2.1.170`) — now falls back to Damerau-Levenshtein distance-1 matching against canonical ids and multi-letter aliases: `cladue` -> `claude` (transposition), `kim` -> `kimi`, `codx` -> `codex`, `gemni` -> `gemini`.

package/dist/commands/inspect.d.ts

@@ -24,6 +24,8 @@ interface ResourceItem {
     linkTarget: string;
     /** One-line description (frontmatter `description:` or first non-frontmatter line). */
     description: string;
+    /** Extra detail rows surfaced in detail mode (e.g. a plugin's bundled skills/commands). */
+    extra?: Array<[string, string]>;
 }
 interface InspectOptions {
     brief?: boolean;

package/dist/commands/inspect.js

@@ -23,7 +23,7 @@ import { readMeta, getUserAgentsDir, getSystemAgentsDir, getProjectAgentsDir, ge
 import { getVersionHomePath } from '../lib/versions.js';
 import { getShimsDir, getVersionedAliasPath } from '../lib/shims.js';
 import { getAgentResources, listResources, } from '../lib/resources.js';
-import { discoverPlugins } from '../lib/plugins.js';
+import { discoverPlugins, discoverPluginsInDir } from '../lib/plugins.js';
 import { countSessionsInScope } from '../lib/session/discover.js';
 import { damerauLevenshtein } from '../lib/fuzzy.js';
 /** Resource kinds the inspect command can drill into. */
@@ -161,18 +161,23 @@ export function resolveRepoTarget(target, cwd) {
     const stat = safeStat(abs);
     if (!stat || !stat.isDirectory())
         return null;
-    // A dir that is itself a DotAgents root wins over its nested .agents/ —
-    // extra repos like ~/.agents-extras keep resources at the top level and use
-    // .agents/ only for worktrees.
+    // A dir literally named `.agents` is the root itself.
+    if (path.basename(abs) === '.agents') {
+        return { label: path.basename(path.dirname(abs)), root: abs };
+    }
+    // A nested `.agents/` that is a populated DotAgents root wins over `abs` — the
+    // project case (`agents inspect .` from a repo root whose resources live under
+    // `.agents/`, while the repo's own top-level `skills/`, `agents.yaml` pin, etc.
+    // are unrelated source, not a DotAgents tree).
+    const nested = path.join(abs, '.agents');
+    if (isDotAgentsRoot(nested)) {
+        return { label: path.basename(abs), root: nested };
+    }
+    // Otherwise treat `abs` itself as the root: standalone clones and extra repos
+    // like ~/.agents-extras keep resources at the top level and use `.agents/`
+    // only for worktrees (so their nested `.agents/` is not a DotAgents root).
     if (isDotAgentsRoot(abs)) {
-        const label = path.basename(abs) === '.agents' ? path.basename(path.dirname(abs)) : path.basename(abs);
-        return { label, root: abs };
-    }
-    if (path.basename(abs) !== '.agents') {
-        const nested = path.join(abs, '.agents');
-        if (safeStat(nested)?.isDirectory()) {
-            return { label: path.basename(abs), root: nested };
-        }
+        return { label: path.basename(abs), root: abs };
     }
     return null;
 }
@@ -204,6 +209,14 @@ async function inspectRepo(repo, options) {
 }
 /** List one resource kind from a single repo root — no layering, no overrides. */
 export function collectRepoKind(repo, kind) {
+    // Plugins are bundles with a manifest + nested skills/commands/hooks — read
+    // them through the plugin discoverer so the manifest description and bundled
+    // resources surface, rather than treating each as an opaque directory.
+    if (kind === 'plugins') {
+        return discoverPluginsInDir(path.join(repo.root, 'plugins'))
+            .map(p => pluginToItem(p, repo.label))
+            .sort((a, b) => a.name.localeCompare(b.name));
+    }
     const dir = path.join(repo.root, kind);
     let entries;
     try {
@@ -486,14 +499,35 @@ function collectKind(agent, versionHome, kind) {
     }
 }
 function pluginItems() {
-    const plugins = discoverPlugins();
-    return plugins.map(p => ({
-        name: p.name,
-        source: 'user',
-        path: p.root,
-        linkTarget: linkTarget(p.root),
-        description: p.manifest.description ?? '',
-    }));
+    return discoverPlugins().map(p => pluginToItem(p, 'user'));
+}
+/**
+ * Map a discovered plugin to a resource item, surfacing the manifest description
+ * and the bundle's nested resources (skills, commands, hooks, ...) as detail rows.
+ */
+function pluginToItem(plugin, source) {
+    const extra = [];
+    const list = (names) => names.length <= 8 ? names.join(', ') : `${names.slice(0, 8).join(', ')}, +${names.length - 8} more`;
+    if (plugin.skills.length)
+        extra.push(['skills', `${plugin.skills.length}  (${list(plugin.skills)})`]);
+    if (plugin.commands.length)
+        extra.push(['commands', `${plugin.commands.length}  (${list(plugin.commands)})`]);
+    if (plugin.agentDefs.length)
+        extra.push(['subagents', `${plugin.agentDefs.length}  (${list(plugin.agentDefs)})`]);
+    if (plugin.hooks.length)
+        extra.push(['hooks', String(plugin.hooks.length)]);
+    if (plugin.mcpServers.length)
+        extra.push(['mcp', list(plugin.mcpServers)]);
+    if (plugin.manifest.version)
+        extra.push(['version', plugin.manifest.version]);
+    return {
+        name: plugin.name,
+        source,
+        path: plugin.root,
+        linkTarget: linkTarget(plugin.root),
+        description: plugin.manifest.description ?? '',
+        extra,
+    };
 }
 function entriesFromAgentResources(agent, versionHome, kind) {
     const res = getAgentResources(agent, { home: versionHome });
@@ -562,6 +596,10 @@ function buildDetailRows(item, kind) {
                 rows.push(['tools', fm.tools.join(', ')]);
         }
     }
+    // Plugin bundles carry their nested resources as pre-built rows.
+    if (kind === 'plugins' && item.extra) {
+        rows.push(...item.extra);
+    }
     return rows;
 }
 function findMatches(items, query) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phnx-labs/agents-cli",
-  "version": "1.20.9",
+  "version": "1.20.10",
   "description": "One CLI for all your AI coding agents - versions, config, cloud dispatch, sessions, and teams (now with first-class Grok Build CLI support)",
   "type": "module",
   "main": "dist/index.js",