@unbrained/pm-cli 2026.5.10 → 2026.5.12

package/{.agents/pm → packages/pm-beads}/extensions/beads/index.js

@@ -1,7 +1,8 @@
 import path from "node:path";
-import { pathToFileURL } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 
 const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
+const CURRENT_EXTENSION_ROOT = path.dirname(fileURLToPath(import.meta.url));
 
 export const manifest = {
   name: "builtin-beads-import",
@@ -48,17 +49,31 @@ function resolvePackageRootCandidates() {
 async function loadRuntimeModule() {
   const attempted = [];
   for (const packageRoot of resolvePackageRootCandidates()) {
-    const modulePath = path.join(packageRoot, ".agents", "pm", "extensions", "beads", "runtime.js");
-    attempted.push(modulePath);
-    try {
-      return await import(pathToFileURL(modulePath).href);
-    } catch {
-      // Try the next package-root candidate.
+    const modulePaths = [
+      path.join(packageRoot, ".agents", "pm", "extensions", "beads", "runtime.js"),
+      path.join(packageRoot, "packages", "pm-beads", "extensions", "beads", "runtime.js"),
+    ];
+    for (const modulePath of modulePaths) {
+      attempted.push(modulePath);
+      try {
+        return await import(pathToFileURL(modulePath).href);
+      } catch {
+        // Try the next package-root candidate.
+      }
     }
   }
+
+  const localRuntimePath = path.join(CURRENT_EXTENSION_ROOT, "runtime.js");
+  attempted.push(localRuntimePath);
+  try {
+    return await import(pathToFileURL(localRuntimePath).href);
+  } catch {
+    // Fall through to the diagnostic below.
+  }
+
   throw new Error(
-    "Unable to resolve bundled beads extension runtime module. " +
-      `Tried: ${attempted.join(", ")}. Ensure PM_CLI_PACKAGE_ROOT points to an installed pm package root.`,
+    "Unable to resolve packaged beads extension runtime module. " +
+      `Tried: ${attempted.join(", ")}. Ensure the installed extension includes runtime.js or PM_CLI_PACKAGE_ROOT points to an installed pm package root.`,
   );
 }
 

package/packages/pm-beads/extensions/beads/index.ts

@@ -0,0 +1,131 @@
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import type { CommandDefinition, ExtensionApi } from "../../../../src/core/extensions/loader.js";
+import type { GlobalOptions } from "../../../../src/core/shared/command-types.js";
+import type { BeadsImportOptions, BeadsImportResult } from "./runtime.js";
+
+const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
+const CURRENT_EXTENSION_ROOT = path.dirname(fileURLToPath(import.meta.url));
+
+export const manifest = {
+  name: "builtin-beads-import",
+  version: "0.1.0",
+  entry: "./index.js",
+  priority: 0,
+  capabilities: ["commands", "schema"],
+};
+
+type RuntimeModule = {
+  runBeadsImport?: (options: BeadsImportOptions, global: GlobalOptions) => Promise<BeadsImportResult>;
+};
+
+function asOptionalString(value: unknown): string | undefined {
+  return typeof value === "string" ? value : undefined;
+}
+
+function asBoolean(value: unknown): boolean | undefined {
+  return typeof value === "boolean" ? value : undefined;
+}
+
+function toBeadsImportOptions(options: Record<string, unknown>): BeadsImportOptions {
+  return {
+    file: asOptionalString(options.file),
+    author: asOptionalString(options.author),
+    message: asOptionalString(options.message),
+    preserveSourceIds: asBoolean(options.preserveSourceIds),
+  };
+}
+
+function resolvePackageRootCandidates(): string[] {
+  const candidates: string[] = [];
+  const envRoot = process.env[PM_PACKAGE_ROOT_ENV];
+  if (typeof envRoot === "string" && envRoot.trim().length > 0) {
+    candidates.push(path.resolve(envRoot.trim()));
+  }
+  const argvEntry = typeof process.argv[1] === "string" ? process.argv[1].trim() : "";
+  if (argvEntry.length > 0) {
+    const resolvedEntry = path.resolve(argvEntry);
+    const entryDir = path.dirname(resolvedEntry);
+    candidates.push(path.resolve(entryDir, ".."));
+    candidates.push(path.resolve(entryDir, "../.."));
+    candidates.push(path.resolve(entryDir, "../../.."));
+  }
+  return [...new Set(candidates)];
+}
+
+async function loadRuntimeModule(): Promise<RuntimeModule> {
+  const attempted: string[] = [];
+  for (const packageRoot of resolvePackageRootCandidates()) {
+    const modulePaths = [
+      path.join(packageRoot, ".agents", "pm", "extensions", "beads", "runtime.js"),
+      path.join(packageRoot, "packages", "pm-beads", "extensions", "beads", "runtime.js"),
+    ];
+    for (const modulePath of modulePaths) {
+      attempted.push(modulePath);
+      try {
+        return await import(pathToFileURL(modulePath).href) as RuntimeModule;
+      } catch {
+        // Try the next package-root candidate.
+      }
+    }
+  }
+
+  const localRuntimePath = path.join(CURRENT_EXTENSION_ROOT, "runtime.js");
+  attempted.push(localRuntimePath);
+  try {
+    return await import(pathToFileURL(localRuntimePath).href) as RuntimeModule;
+  } catch {
+    // Fall through to the diagnostic below.
+  }
+
+  throw new Error(
+    "Unable to resolve packaged beads extension runtime module. " +
+      `Tried: ${attempted.join(", ")}. Ensure the installed extension includes runtime.js or PM_CLI_PACKAGE_ROOT points to an installed pm package root.`,
+  );
+}
+
+async function runBeadsImportFromRuntime(options: BeadsImportOptions, global: GlobalOptions): Promise<BeadsImportResult> {
+  const runtime = await loadRuntimeModule();
+  if (typeof runtime.runBeadsImport !== "function") {
+    throw new Error("Bundled beads runtime module is missing runBeadsImport().");
+  }
+  return runtime.runBeadsImport(options, global);
+}
+
+export function activate(api: ExtensionApi): void {
+  api.registerCommand({
+    name: "beads import",
+    description: "Import Beads JSONL records into pm items.",
+    flags: [
+      {
+        long: "--file",
+        value_name: "path",
+        value_type: "string",
+        description: "Path to the Beads JSONL source file.",
+      },
+      {
+        long: "--author",
+        value_name: "author",
+        value_type: "string",
+        description: "Override import mutation author.",
+      },
+      {
+        long: "--message",
+        value_name: "text",
+        value_type: "string",
+        description: "Override import history message.",
+      },
+      {
+        long: "--preserve-source-ids",
+        value_type: "boolean",
+        description: "Preserve source IDs from Beads payload records when possible.",
+      },
+    ],
+    run: async (context) => runBeadsImportFromRuntime(toBeadsImportOptions(context.options), context.global),
+  } satisfies CommandDefinition);
+}
+
+export default {
+  manifest,
+  activate,
+};

package/packages/pm-beads/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@unbrained/pm-package-beads",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "First-party pm package for importing Beads JSONL records.",
+  "keywords": [
+    "pm-package",
+    "project-management",
+    "beads"
+  ],
+  "pm": {
+    "extensions": [
+      "extensions/beads"
+    ]
+  }
+}

package/packages/pm-todos/README.md

@@ -0,0 +1,11 @@
+# pm Todos Package
+
+First-party pm package for Todo markdown import and export.
+
+```bash
+pm install ./packages/pm-todos --project
+pm todos import --folder .pm/todos
+pm todos export --folder .pm/todos
+```
+
+The package exposes the `todos import` and `todos export` extension commands through the `pm.extensions` package manifest. Runtime sources are authored in TypeScript and shipped with JavaScript entry artifacts for Node extension loading.

package/{.agents/pm → packages/pm-todos}/extensions/todos/index.js

@@ -1,7 +1,8 @@
 import path from "node:path";
-import { pathToFileURL } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 
 const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
+const CURRENT_EXTENSION_ROOT = path.dirname(fileURLToPath(import.meta.url));
 
 export const manifest = {
   name: "builtin-todos-import-export",
@@ -49,17 +50,31 @@ function resolvePackageRootCandidates() {
 async function loadRuntimeModule() {
   const attempted = [];
   for (const packageRoot of resolvePackageRootCandidates()) {
-    const modulePath = path.join(packageRoot, ".agents", "pm", "extensions", "todos", "runtime.js");
-    attempted.push(modulePath);
-    try {
-      return await import(pathToFileURL(modulePath).href);
-    } catch {
-      // Try the next package-root candidate.
+    const modulePaths = [
+      path.join(packageRoot, ".agents", "pm", "extensions", "todos", "runtime.js"),
+      path.join(packageRoot, "packages", "pm-todos", "extensions", "todos", "runtime.js"),
+    ];
+    for (const modulePath of modulePaths) {
+      attempted.push(modulePath);
+      try {
+        return await import(pathToFileURL(modulePath).href);
+      } catch {
+        // Try the next package-root candidate.
+      }
     }
   }
+
+  const localRuntimePath = path.join(CURRENT_EXTENSION_ROOT, "runtime.js");
+  attempted.push(localRuntimePath);
+  try {
+    return await import(pathToFileURL(localRuntimePath).href);
+  } catch {
+    // Fall through to the diagnostic below.
+  }
+
   throw new Error(
-    "Unable to resolve bundled todos extension runtime module. " +
-      `Tried: ${attempted.join(", ")}. Ensure PM_CLI_PACKAGE_ROOT points to an installed pm package root.`,
+    "Unable to resolve packaged todos extension runtime module. " +
+      `Tried: ${attempted.join(", ")}. Ensure the installed extension includes runtime.js or PM_CLI_PACKAGE_ROOT points to an installed pm package root.`,
   );
 }
 

package/packages/pm-todos/extensions/todos/index.ts

@@ -0,0 +1,149 @@
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import type { CommandDefinition, ExtensionApi } from "../../../../src/core/extensions/loader.js";
+import type { GlobalOptions } from "../../../../src/core/shared/command-types.js";
+import type { TodosExportOptions, TodosExportResult, TodosImportOptions, TodosImportResult } from "./runtime.js";
+
+const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
+const CURRENT_EXTENSION_ROOT = path.dirname(fileURLToPath(import.meta.url));
+
+export const manifest = {
+  name: "builtin-todos-import-export",
+  version: "0.1.0",
+  entry: "./index.js",
+  priority: 0,
+  capabilities: ["commands", "schema"],
+};
+
+type RuntimeModule = {
+  runTodosImport?: (options: TodosImportOptions, global: GlobalOptions) => Promise<TodosImportResult>;
+  runTodosExport?: (options: TodosExportOptions, global: GlobalOptions) => Promise<TodosExportResult>;
+};
+
+function asOptionalString(value: unknown): string | undefined {
+  return typeof value === "string" ? value : undefined;
+}
+
+function toImportOptions(options: Record<string, unknown>): TodosImportOptions {
+  return {
+    folder: asOptionalString(options.folder),
+    author: asOptionalString(options.author),
+    message: asOptionalString(options.message),
+  };
+}
+
+function toExportOptions(options: Record<string, unknown>): TodosExportOptions {
+  return {
+    folder: asOptionalString(options.folder),
+  };
+}
+
+function resolvePackageRootCandidates(): string[] {
+  const candidates: string[] = [];
+  const envRoot = process.env[PM_PACKAGE_ROOT_ENV];
+  if (typeof envRoot === "string" && envRoot.trim().length > 0) {
+    candidates.push(path.resolve(envRoot.trim()));
+  }
+  const argvEntry = typeof process.argv[1] === "string" ? process.argv[1].trim() : "";
+  if (argvEntry.length > 0) {
+    const resolvedEntry = path.resolve(argvEntry);
+    const entryDir = path.dirname(resolvedEntry);
+    candidates.push(path.resolve(entryDir, ".."));
+    candidates.push(path.resolve(entryDir, "../.."));
+    candidates.push(path.resolve(entryDir, "../../.."));
+  }
+  return [...new Set(candidates)];
+}
+
+async function loadRuntimeModule(): Promise<RuntimeModule> {
+  const attempted: string[] = [];
+  for (const packageRoot of resolvePackageRootCandidates()) {
+    const modulePaths = [
+      path.join(packageRoot, ".agents", "pm", "extensions", "todos", "runtime.js"),
+      path.join(packageRoot, "packages", "pm-todos", "extensions", "todos", "runtime.js"),
+    ];
+    for (const modulePath of modulePaths) {
+      attempted.push(modulePath);
+      try {
+        return await import(pathToFileURL(modulePath).href) as RuntimeModule;
+      } catch {
+        // Try the next package-root candidate.
+      }
+    }
+  }
+
+  const localRuntimePath = path.join(CURRENT_EXTENSION_ROOT, "runtime.js");
+  attempted.push(localRuntimePath);
+  try {
+    return await import(pathToFileURL(localRuntimePath).href) as RuntimeModule;
+  } catch {
+    // Fall through to the diagnostic below.
+  }
+
+  throw new Error(
+    "Unable to resolve packaged todos extension runtime module. " +
+      `Tried: ${attempted.join(", ")}. Ensure the installed extension includes runtime.js or PM_CLI_PACKAGE_ROOT points to an installed pm package root.`,
+  );
+}
+
+async function runTodosImportFromRuntime(options: TodosImportOptions, global: GlobalOptions): Promise<TodosImportResult> {
+  const runtime = await loadRuntimeModule();
+  if (typeof runtime.runTodosImport !== "function") {
+    throw new Error("Bundled todos runtime module is missing runTodosImport().");
+  }
+  return runtime.runTodosImport(options, global);
+}
+
+async function runTodosExportFromRuntime(options: TodosExportOptions, global: GlobalOptions): Promise<TodosExportResult> {
+  const runtime = await loadRuntimeModule();
+  if (typeof runtime.runTodosExport !== "function") {
+    throw new Error("Bundled todos runtime module is missing runTodosExport().");
+  }
+  return runtime.runTodosExport(options, global);
+}
+
+export function activate(api: ExtensionApi): void {
+  api.registerCommand({
+    name: "todos import",
+    description: "Import Todo markdown files into pm items.",
+    flags: [
+      {
+        long: "--folder",
+        value_name: "path",
+        value_type: "string",
+        description: "Source folder containing Todo markdown files.",
+      },
+      {
+        long: "--author",
+        value_name: "author",
+        value_type: "string",
+        description: "Override import mutation author.",
+      },
+      {
+        long: "--message",
+        value_name: "text",
+        value_type: "string",
+        description: "Override import history message.",
+      },
+    ],
+    run: async (context) => runTodosImportFromRuntime(toImportOptions(context.options), context.global),
+  } satisfies CommandDefinition);
+  api.registerCommand({
+    name: "todos export",
+    description: "Export pm items into Todo markdown files.",
+    flags: [
+      {
+        long: "--folder",
+        value_name: "path",
+        value_type: "string",
+        description: "Destination folder for exported Todo markdown files.",
+      },
+    ],
+    run: async (context) => runTodosExportFromRuntime(toExportOptions(context.options), context.global),
+  } satisfies CommandDefinition);
+}
+
+export default {
+  manifest,
+  activate,
+};

package/{.agents/pm → packages/pm-todos}/extensions/todos/runtime.js

@@ -16,7 +16,7 @@ import { listAllFrontMatter, locateItem, readLocatedItem } from "../../../../dis
 import { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from "../../../../dist/core/store/paths.js";
 import { readSettings } from "../../../../dist/core/store/settings.js";
 import { CONFIDENCE_TEXT_VALUES, ISSUE_SEVERITY_VALUES, RISK_VALUES } from "../../../../dist/types/index.js";
-const DEFAULT_TODOS_FOLDER = ".pi/todos";
+const DEFAULT_TODOS_FOLDER = ".pm/todos";
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }

package/{.agents/pm → packages/pm-todos}/extensions/todos/runtime.ts

@@ -20,7 +20,7 @@ import { readSettings } from "../../../../src/core/store/settings.js";
 import { CONFIDENCE_TEXT_VALUES, ISSUE_SEVERITY_VALUES, RISK_VALUES } from "../../../../src/types/index.js";
 import type { ItemDocument, ItemMetadata, ItemStatus, ItemType, PmSettings } from "../../../../src/types/index.js";
 
-const DEFAULT_TODOS_FOLDER = ".pi/todos";
+const DEFAULT_TODOS_FOLDER = ".pm/todos";
 
 export interface TodosImportOptions {
   folder?: string;

package/packages/pm-todos/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@unbrained/pm-package-todos",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "First-party pm package for Todo markdown import and export.",
+  "keywords": [
+    "pm-package",
+    "project-management",
+    "todos"
+  ],
+  "pm": {
+    "extensions": [
+      "extensions/todos"
+    ]
+  }
+}

package/plugins/pm-cli-claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pm-cli",
-  "description": "Native pm CLI integration for Claude Code — 18 MCP tools, 5 workflow skills, 14 slash commands, hybrid TUI task tracking (pm as persistent store + Claude Code task panel as live view), session context injection, and a coordination subagent for git-based project management without leaving Claude Code.",
-  "version": "1.2.0",
+  "description": "Native pm CLI integration for Claude Code — 18 MCP tools, 5 workflow skills, 14 slash commands, 3 subagents (coordinator, triage, verification), hybrid TUI task tracking (pm as persistent store + Claude Code task panel as live view), session context injection, and full git-based project management without leaving Claude Code.",
+  "version": "1.3.0",
   "author": {
     "name": "unbrained",
     "url": "https://github.com/unbraind/pm-cli"

package/plugins/pm-cli-claude/README.md

@@ -1,6 +1,6 @@
 # pm CLI — Claude Code Plugin
 
-Native pm CLI integration for Claude Code. Use pm project management tools directly through Claude Code's MCP protocol — no shell invocations, no context switching.
+Native pm CLI integration for Claude Code. Use pm project management tools directly through Claude Code's MCP protocol — no shell invocations, no context switching, no `pm` CLI required.
 
 ## What's Included
 
@@ -9,29 +9,37 @@ Native pm CLI integration for Claude Code. Use pm project management tools direc
 | **18 MCP tools** | Full pm surface: context, search, list, get, create, update, claim, release, close, comments, files, docs, test, validate, health, contracts, guide + `pm_run` for everything else |
 | **5 skills** | `pm-workflow`, `pm-developer`, `pm-release`, `pm-audit`, `pm-planner` — auto-loaded as Claude Code skills |
 | **14 slash commands** | Full lifecycle coverage — status, start, close, triage, audit, search, new, list, calendar, developer, planner, release, workflow, init |
+| **3 subagents** | `pm-coordinator` (batch/multi-item), `pm-triage-agent` (duplicate-safe item creation), `pm-verification-agent` (evidence + close readiness), and a `pm-delivery-chain` orchestrator |
 | **Hybrid TUI tracking** | pm items sync to Claude Code's task panel — pm is the persistent store, the task panel is the live session view |
-| **Session hook** | Injects active pm item summary at session start when pm is initialized |
-| **pm-coordinator agent** | Subagent for coordinating multi-item and batch operations |
+| **Session hook** | Injects active pm item summary at session start when pm is initialized (uses native modules, no CLI required) |
 
 ## Installation
 
-### Option A: Plugin marketplace (recommended)
+### Option A: Plugin marketplace — canonical install (recommended)
 
 ```
-/plugin install pm-cli@pm-cli
+/plugin install pm-cli@pm
 ```
 
-This installs the plugin including all MCP tools, skills, slash commands, hybrid TUI tracking, and the session hook in one step.
-
-To add the marketplace first (if not already configured):
+First time: add the marketplace if it's not configured yet:
 
 ```bash
 claude plugin marketplace add /path/to/pm-cli
-# or from GitHub:
+# or after npm publish:
 # claude plugin marketplace add unbraind/pm-cli
 ```
 
-### Option B: Global MCP server via Claude Code CLI (MCP tools only)
+This installs all 18 MCP tools, 5 skills, 14 slash commands, 3 subagents, hybrid TUI tracking, and the session hook in one step.
+
+### Option B: Legacy marketplace alias (also works)
+
+```
+/plugin install pm-cli@pm-cli
+```
+
+Both `pm` and `pm-cli` marketplace IDs resolve to the same plugin.
+
+### Option C: Global MCP server via Claude Code CLI (MCP tools only)
 
 ```bash
 claude mcp add --transport stdio pm-cli-native -- npx -y @unbrained/pm-cli pm-mcp
@@ -39,9 +47,9 @@ claude mcp add --transport stdio pm-cli-native -- npx -y @unbrained/pm-cli pm-mc
 
 This gives you the 18 MCP tools but not the skills, slash commands, or session hook.
 
-### Option C: Direct `.mcp.json` (project-scoped MCP only)
+### Option D: Direct `.mcp.json` (project-scoped MCP only)
 
-Add to your project's `.mcp.json` for MCP tools in a single project:
+Add to your project's `.mcp.json`:
 
 ```json
 {
@@ -70,6 +78,9 @@ Start working on the authentication bug.
 
 Close pm-xxxx — the fix is complete.
 → Claude runs /pm-close-task pm-xxxx with evidence linking, closes pm item, marks task panel entry completed
+
+Triage this request: add dark mode toggle to settings screen
+→ Claude spawns pm-triage-agent, checks duplicates, creates pm item with AC, hands off to /pm-developer
 ```
 
 ## Hybrid TUI Task Tracking
@@ -116,6 +127,20 @@ This means you get full history in pm (survives restarts, visible in `pm list`)
 | `pm-audit` | Repository health audits — validate, dedupe, aggregate |
 | `pm-planner` | Planning — decompose epics, prioritize backlog, triage |
 
+## Subagents
+
+| Agent | Role |
+|-------|------|
+| `pm-coordinator` | Multi-item and batch coordination — batch updates, audit workflows, release gate sequences |
+| `pm-triage-agent` | Duplicate-safe item creation — orient, search, establish lineage, produce implementation-ready item |
+| `pm-verification-agent` | Closure evidence — read item, check AC, run tests, validate, produce structured close recommendation |
+| `pm-delivery-chain` | End-to-end orchestrator — runs triage → implement → verify as a single tracked loop |
+
+Use subagents via Claude Code's built-in `Agent` tool:
+```
+Spawn pm-triage-agent to set up the pm item for: add OAuth2 login support
+```
+
 ## MCP Tools Reference
 
 ### Narrow tools (prefer these)
@@ -163,6 +188,21 @@ All skills and commands implement this pattern for every claimed item:
    → [✔ appears in Claude Code task panel]
 ```
 
+## Session Context Injection
+
+At session start, the hook runs natively (no `pm` CLI required):
+- Uses `npx @unbrained/pm-cli` without requiring a global install
+- Injects a compact summary of in-progress/open/blocked items
+
+Example output:
+```
+pm tracker: 2 in_progress, 1 open
+  • [pm-abc1] Add OAuth2 login (in_progress)
+  • [pm-abc2] Fix test flakiness (in_progress)
+  • [pm-abc3] Update docs (open)
+Use pm_context tool or /pm-status for full details.
+```
+
 ## Safety
 
 - Never pass `path` during real repository tracking — only use it for sandbox/test runs.
@@ -173,12 +213,12 @@ All skills and commands implement this pattern for every claimed item:
 ## Requirements
 
 - Node.js ≥ 20
-- pm CLI available via npx (auto-resolved) or installed globally: `npm install -g @unbrained/pm-cli`
+- pm CLI resolved automatically via local dist (in repo) or `npx @unbrained/pm-cli` (no global install needed)
 - Project initialized with `pm init` (or use `/pm-init`)
 
 ## Links
 
 - [pm CLI docs](https://github.com/unbraind/pm-cli/tree/main/docs)
-- [Command reference](https://github.com/unbraind/pm-cli/blob/main/docs/COMMANDS.md)
 - [Architecture guide](https://github.com/unbraind/pm-cli/blob/main/docs/ARCHITECTURE.md)
+- [Extension guide](https://github.com/unbraind/pm-cli/blob/main/docs/EXTENSIONS.md)
 - [CHANGELOG](https://github.com/unbraind/pm-cli/blob/main/CHANGELOG.md)