@agentprojectcontext/apx 1.74.2 → 1.76.0

package/src/interfaces/cli/index.js

@@ -151,6 +151,16 @@ import {
   cmdTaskReopen,
   cmdTaskPatch,
 } from "./commands/task.js";
+import {
+  cmdProfileList,
+  cmdProfileShow,
+  cmdProfileInstall,
+  cmdProfileUse,
+  cmdProfileOff,
+  cmdProfileConfig,
+  cmdProfileDoctor,
+  cmdProfileUninstall,
+} from "./commands/profile.js";
 import {
   cmdOrgShow,
   cmdOrgAreaAdd,
@@ -1607,6 +1617,42 @@ const HELP_TOPICS = new Map(Object.entries({
     examples: ["apx plugins status telegram"],
   }),
 
+  profile: topic({
+    title: "apx profile",
+    summary:
+      "Install, activate and configure the super-agent's line of work. With no profile active, APX behaves exactly as it always has.",
+    usage: ["apx profile <subcommand> [args] [--flags]"],
+    commands: [
+      ["list | ls", "Show every available profile and which one is active."],
+      ["show | get <id>", "Details, settings and token cost of one profile."],
+      ["install | add <id|path>", "Validate and install a profile. Does NOT activate it."],
+      ["use | activate <id>", "Make a profile active and install its routines."],
+      ["off | deactivate", "Go back to vanilla. Disables its routines, deletes nothing."],
+      ["config", "Show or change the active profile's settings."],
+      ["doctor [<id>]", "What is missing for this profile to do its job."],
+      ["uninstall | remove <id>", "Remove a profile, keeping anything you edited."],
+    ],
+    options: [
+      ["--preview", "show: also print the rendered prompt block."],
+      ["--set <key=value>", "config: set one setting. Repeatable."],
+      ["--interactive", "config: walk through every setting."],
+      ["--force", "install: overwrite. use: replace the active profile."],
+    ],
+    examples: [
+      "apx profile list",
+      "apx profile install secretary",
+      "apx profile use secretary",
+      "apx profile config --set day_open_at=08:30 --set nudge_budget_per_day=3",
+      "apx profile show secretary --preview",
+      "apx profile off",
+    ],
+  }),
+  profiles: topic({
+    title: "apx profiles",
+    summary: "Alias for apx profile.",
+    usage: ["apx profiles <subcommand>"],
+    examples: ["apx profiles list"],
+  }),
   task: topic({
     title: "apx task",
     summary: "Per-project TODO list backed by the daemon (/projects/:pid/tasks).",
@@ -1620,10 +1666,16 @@ const HELP_TOPICS = new Map(Object.entries({
       ["reopen <id>", "Reopen a done or dropped task."],
       ["patch | edit <id>", "Edit fields on an existing task."],
     ],
-    options: [["--project <name|id|path>", "Pin command to a specific project."]],
+    options: [
+      ["--project <name|id|path>", "Pin command to a specific project."],
+      ["--all", "list: fold every registered project into one list, each row labelled."],
+      ["--status <s>", "list: workflow sub-status — pending | running | in_review | blocked."],
+      ["--updated-since <ISO>", "list: only what moved since that moment."],
+    ],
     examples: [
       "apx task add \"Ship release notes\" --tag release --due 2026-06-01",
       "apx task list --state open --tag release",
+      "apx task list --all --status blocked",
       "apx task done t_abc123",
     ],
   }),
@@ -2753,6 +2805,22 @@ async function dispatch(cmd, rest) {
         break;
       }
 
+      case "profile":
+      case "profiles": {
+        const sub = rest[0];
+        const a = parseArgs(rest.slice(1));
+        if (!sub || sub === "list" || sub === "ls") await cmdProfileList(a);
+        else if (sub === "show" || sub === "get") await cmdProfileShow(a);
+        else if (sub === "install" || sub === "add") await cmdProfileInstall(a);
+        else if (sub === "use" || sub === "activate") await cmdProfileUse(a);
+        else if (sub === "off" || sub === "deactivate") await cmdProfileOff(a);
+        else if (sub === "config") await cmdProfileConfig(a);
+        else if (sub === "doctor") await cmdProfileDoctor(a);
+        else if (sub === "uninstall" || sub === "remove" || sub === "rm") await cmdProfileUninstall(a);
+        else die(`unknown profile subcommand: ${sub}\nUsage: apx profile <list|show|install|use|off|config|doctor|uninstall>`);
+        break;
+      }
+
       case "command":
       case "commands": {
         const sub = rest[0];