npm - @proletariat/cli - Versions diffs - 0.3.102 → 0.3.103 - Mend

@proletariat/cli 0.3.102 → 0.3.103

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (25) hide show

package/dist/lib/orchestrate/engine.d.ts +19 -39
package/dist/lib/orchestrate/engine.js +51 -215
package/dist/lib/orchestrate/engine.js.map +1 -1
package/dist/lib/orchestrate/types.d.ts +3 -11
package/dist/lib/orchestrate/types.js +1 -2
package/dist/lib/orchestrate/types.js.map +1 -1
package/dist/lib/work-lifecycle/hooks/executor.js +2 -0
package/dist/lib/work-lifecycle/hooks/executor.js.map +1 -1
package/dist/lib/work-lifecycle/hooks/index.d.ts +5 -3
package/dist/lib/work-lifecycle/hooks/index.js +3 -2
package/dist/lib/work-lifecycle/hooks/index.js.map +1 -1
package/dist/lib/work-lifecycle/hooks/manager.d.ts +93 -8
package/dist/lib/work-lifecycle/hooks/manager.js +248 -20
package/dist/lib/work-lifecycle/hooks/manager.js.map +1 -1
package/dist/lib/work-lifecycle/hooks/storage.d.ts +1 -0
package/dist/lib/work-lifecycle/hooks/storage.js +28 -6
package/dist/lib/work-lifecycle/hooks/storage.js.map +1 -1
package/dist/lib/work-lifecycle/hooks/types.d.ts +37 -0
package/dist/lib/work-lifecycle/hooks/types.js +2 -0
package/dist/lib/work-lifecycle/hooks/types.js.map +1 -1
package/dist/lib/work-lifecycle/index.d.ts +2 -1
package/dist/lib/work-lifecycle/index.js +1 -1
package/dist/lib/work-lifecycle/index.js.map +1 -1
package/oclif.manifest.json +1018 -1018
package/package.json +1 -1

package/oclif.manifest.json CHANGED Viewed

@@ -1972,66 +1972,6 @@
         "sync.js"
       ]
     },
-    "autocomplete:setup": {
-      "aliases": [],
-      "args": {},
-      "description": "Auto-detect shell and set up autocomplete",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --install",
-        "<%= config.bin %> <%= command.id %> --shell zsh",
-        "<%= config.bin %> <%= command.id %> --shell zsh --install --machine"
-      ],
-      "flags": {
-        "json": {
-          "description": "Output as JSON for AI agents/scripts",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "machine": {
-          "char": "m",
-          "description": "Output as JSON for AI agents/scripts",
-          "name": "machine",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "install": {
-          "char": "i",
-          "description": "Automatically install to shell config file",
-          "name": "install",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "shell": {
-          "char": "s",
-          "description": "Override shell detection (zsh, bash, powershell)",
-          "name": "shell",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "zsh",
-            "bash",
-            "powershell"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "autocomplete:setup",
-      "pluginAlias": "@proletariat/cli",
-      "pluginName": "@proletariat/cli",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "autocomplete",
-        "setup.js"
-      ]
-    },
     "branch:create": {
       "aliases": [],
       "args": {
@@ -2576,6 +2516,66 @@
         "stop.js"
       ]
     },
+    "autocomplete:setup": {
+      "aliases": [],
+      "args": {},
+      "description": "Auto-detect shell and set up autocomplete",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --install",
+        "<%= config.bin %> <%= command.id %> --shell zsh",
+        "<%= config.bin %> <%= command.id %> --shell zsh --install --machine"
+      ],
+      "flags": {
+        "json": {
+          "description": "Output as JSON for AI agents/scripts",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "machine": {
+          "char": "m",
+          "description": "Output as JSON for AI agents/scripts",
+          "name": "machine",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "install": {
+          "char": "i",
+          "description": "Automatically install to shell config file",
+          "name": "install",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "shell": {
+          "char": "s",
+          "description": "Override shell detection (zsh, bash, powershell)",
+          "name": "shell",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "zsh",
+            "bash",
+            "powershell"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "autocomplete:setup",
+      "pluginAlias": "@proletariat/cli",
+      "pluginName": "@proletariat/cli",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "autocomplete",
+        "setup.js"
+      ]
+    },
     "claude": {
       "aliases": [],
       "args": {},
@@ -2755,19 +2755,20 @@
         "open.js"
       ]
     },
-    "config": {
+    "codex": {
       "aliases": [],
-      "args": {},
-      "description": "View and update workspace configuration",
+      "args": {
+        "task": {
+          "description": "Task description for the agent",
+          "name": "task",
+          "required": false
+        }
+      },
+      "description": "Quick launch Codex for ad-hoc sessions (works anywhere, no HQ required)",
       "examples": [
-        "<%= config.bin %> <%= command.id %>                    # Interactive menu",
-        "<%= config.bin %> <%= command.id %> --json             # Output current config as JSON",
-        "<%= config.bin %> <%= command.id %> --set terminal.app iTerm",
-        "<%= config.bin %> <%= command.id %> --set terminal.openInBackground true",
-        "<%= config.bin %> <%= command.id %> --set firewall.allowlistDomains \"api.staging.example.com\"",
-        "<%= config.bin %> <%= command.id %> --set review_gate auto        # Set workspace review gate to auto",
-        "<%= config.bin %> <%= command.id %> --set claude-code.version 2.1.80  # Pin Claude Code version",
-        "<%= config.bin %> <%= command.id %> --setting terminal.app --json  # Show terminal app choices"
+        "<%= config.bin %> codex \"fix the bug\"",
+        "<%= config.bin %> codex \"add dark mode\" --permission-mode danger",
+        "<%= config.bin %> codex \"add tests\" --directory ./my-project"
       ],
       "flags": {
         "json": {
@@ -2783,32 +2784,36 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "set": {
-          "char": "s",
-          "description": "Set a config value (format: key value)",
-          "name": "set",
+        "permission-mode": {
+          "char": "p",
+          "description": "Permission mode (danger: skip prompts, safe: require approval)",
+          "name": "permission-mode",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
+          "options": [
+            "danger",
+            "safe"
+          ],
           "type": "option"
         },
-        "list": {
-          "char": "l",
-          "description": "List all configuration values",
-          "name": "list",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "setting": {
-          "description": "Navigate to a specific setting prompt (for agent navigation)",
-          "name": "setting",
+        "directory": {
+          "description": "Directory to run in (default: cwd)",
+          "name": "directory",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "detached": {
+          "char": "d",
+          "description": "Run in background (detached)",
+          "name": "detached",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config",
+      "id": "codex",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
@@ -2817,24 +2822,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
+        "codex",
         "index.js"
       ]
     },
-    "codex": {
+    "config": {
       "aliases": [],
-      "args": {
-        "task": {
-          "description": "Task description for the agent",
-          "name": "task",
-          "required": false
-        }
-      },
-      "description": "Quick launch Codex for ad-hoc sessions (works anywhere, no HQ required)",
+      "args": {},
+      "description": "View and update workspace configuration",
       "examples": [
-        "<%= config.bin %> codex \"fix the bug\"",
-        "<%= config.bin %> codex \"add dark mode\" --permission-mode danger",
-        "<%= config.bin %> codex \"add tests\" --directory ./my-project"
+        "<%= config.bin %> <%= command.id %>                    # Interactive menu",
+        "<%= config.bin %> <%= command.id %> --json             # Output current config as JSON",
+        "<%= config.bin %> <%= command.id %> --set terminal.app iTerm",
+        "<%= config.bin %> <%= command.id %> --set terminal.openInBackground true",
+        "<%= config.bin %> <%= command.id %> --set firewall.allowlistDomains \"api.staging.example.com\"",
+        "<%= config.bin %> <%= command.id %> --set review_gate auto        # Set workspace review gate to auto",
+        "<%= config.bin %> <%= command.id %> --set claude-code.version 2.1.80  # Pin Claude Code version",
+        "<%= config.bin %> <%= command.id %> --setting terminal.app --json  # Show terminal app choices"
       ],
       "flags": {
         "json": {
@@ -2850,36 +2854,32 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "permission-mode": {
-          "char": "p",
-          "description": "Permission mode (danger: skip prompts, safe: require approval)",
-          "name": "permission-mode",
+        "set": {
+          "char": "s",
+          "description": "Set a config value (format: key value)",
+          "name": "set",
           "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "danger",
-            "safe"
-          ],
+          "multiple": true,
           "type": "option"
         },
-        "directory": {
-          "description": "Directory to run in (default: cwd)",
-          "name": "directory",
+        "list": {
+          "char": "l",
+          "description": "List all configuration values",
+          "name": "list",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "setting": {
+          "description": "Navigate to a specific setting prompt (for agent navigation)",
+          "name": "setting",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "detached": {
-          "char": "d",
-          "description": "Run in background (detached)",
-          "name": "detached",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "codex",
+      "id": "config",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
@@ -2888,7 +2888,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "codex",
+        "config",
         "index.js"
       ]
     },
@@ -3009,41 +3009,20 @@
         "repair.js"
       ]
     },
-    "docker:clean": {
+    "execution:config": {
       "aliases": [],
       "args": {},
-      "description": "Remove orphaned containers (containers without running agents)",
+      "description": "View and update execution preferences",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --force",
-        "<%= config.bin %> <%= command.id %> --dry-run"
+        "<%= config.bin %> execution config                    # Interactive menu",
+        "<%= config.bin %> execution config --json             # Output current config as JSON",
+        "<%= config.bin %> execution config --list             # Show all settings",
+        "<%= config.bin %> execution config --set defaultEnvironment host",
+        "<%= config.bin %> execution config --set outputMode interactive",
+        "<%= config.bin %> execution config --set permissionMode safe",
+        "<%= config.bin %> execution config --setting outputMode --json  # Show output mode choices"
       ],
       "flags": {
-        "force": {
-          "aliases": [
-            "yes",
-            "y"
-          ],
-          "char": "f",
-          "description": "Skip confirmation prompt",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would be removed without removing",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "all": {
-          "char": "a",
-          "description": "Remove all stopped devcontainers (not just orphaned)",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "json": {
           "description": "Output as JSON for AI agents/scripts",
           "name": "json",
@@ -3056,41 +3035,54 @@
           "name": "machine",
           "allowNo": false,
           "type": "boolean"
+        },
+        "set": {
+          "char": "s",
+          "description": "Set a config value (format: key value)",
+          "name": "set",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "list": {
+          "char": "l",
+          "description": "List all configuration values",
+          "name": "list",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "setting": {
+          "description": "Navigate to a specific setting prompt (for agent navigation)",
+          "name": "setting",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "docker:clean",
+      "id": "execution:config",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "docker",
-        "clean.js"
+        "execution",
+        "config.js"
       ]
     },
-    "docker": {
+    "execution": {
       "aliases": [],
       "args": {},
-      "description": "Manage Docker containers used by agents",
+      "description": "Single execution operations (view, logs, stop)",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> docker status",
-        "<%= config.bin %> docker list",
-        "<%= config.bin %> docker logs WORK-001",
-        "<%= config.bin %> docker start WORK-001",
-        "<%= config.bin %> docker stop kalanick",
-        "<%= config.bin %> docker shell WORK-001",
-        "<%= config.bin %> docker restart abc123",
-        "<%= config.bin %> docker sync",
-        "<%= config.bin %> docker rebuild-cache",
-        "<%= config.bin %> docker clean",
-        "<%= config.bin %> docker prune"
+        "<%= config.bin %> <%= command.id %> view WORK-001",
+        "<%= config.bin %> <%= command.id %> logs WORK-001",
+        "<%= config.bin %> <%= command.id %> stop WORK-001"
       ],
       "flags": {
         "json": {
@@ -3109,7 +3101,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "docker",
+      "id": "execution",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
@@ -3118,18 +3110,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "docker",
+        "execution",
         "index.js"
       ]
     },
-    "docker:list": {
+    "execution:list": {
       "aliases": [],
       "args": {},
-      "description": "Show Docker containers from agent_work table with status",
+      "description": "List running and recent executions",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --all",
-        "<%= config.bin %> <%= command.id %> --running"
+        "<%= config.bin %> <%= command.id %> --status running",
+        "<%= config.bin %> <%= command.id %> --agent alice",
+        "<%= config.bin %> <%= command.id %> --limit 50"
       ],
       "flags": {
         "json": {
@@ -3145,52 +3138,69 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "all": {
+        "status": {
+          "char": "s",
+          "description": "Filter by status",
+          "name": "status",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "starting",
+            "running",
+            "completed",
+            "failed",
+            "stopped"
+          ],
+          "type": "option"
+        },
+        "agent": {
           "char": "a",
-          "description": "Show all containers (including non-devcontainer)",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
+          "description": "Filter by agent name",
+          "name": "agent",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "running": {
-          "char": "r",
-          "description": "Only show running containers",
-          "name": "running",
-          "allowNo": false,
-          "type": "boolean"
+        "limit": {
+          "char": "l",
+          "description": "Number of results",
+          "name": "limit",
+          "default": 20,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "docker:list",
+      "id": "execution:list",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "docker",
+        "execution",
         "list.js"
       ]
     },
-    "docker:logs": {
+    "execution:logs": {
       "aliases": [],
       "args": {
-        "target": {
-          "description": "Execution ID (WORK-XXX), agent name, or container ID",
-          "name": "target",
-          "required": true
+        "id": {
+          "description": "Execution ID - prompts if not provided",
+          "name": "id",
+          "required": false
         }
       },
-      "description": "View logs from a container (by execution ID, agent name, or container ID)",
+      "description": "View execution logs",
       "examples": [
         "<%= config.bin %> <%= command.id %> WORK-001",
-        "<%= config.bin %> <%= command.id %> kalanick",
-        "<%= config.bin %> <%= command.id %> abc123 --follow",
-        "<%= config.bin %> <%= command.id %> WORK-001 --tail 100"
+        "<%= config.bin %> <%= command.id %> WORK-001 --follow",
+        "<%= config.bin %> <%= command.id %> WORK-001 --tail 50",
+        "<%= config.bin %> <%= command.id %>  # Interactive mode"
       ],
       "flags": {
         "json": {
@@ -3208,86 +3218,54 @@
         },
         "follow": {
           "char": "f",
-          "description": "Follow log output",
+          "description": "Stream logs in real-time",
           "name": "follow",
           "allowNo": false,
           "type": "boolean"
         },
         "tail": {
           "char": "n",
-          "description": "Number of lines to show from the end",
+          "description": "Show last n lines",
           "name": "tail",
-          "default": 100,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "timestamps": {
-          "char": "t",
-          "description": "Show timestamps",
-          "name": "timestamps",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "docker:logs",
+      "id": "execution:logs",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "docker",
+        "execution",
         "logs.js"
       ]
     },
-    "docker:prune": {
+    "execution:stop": {
       "aliases": [],
-      "args": {},
-      "description": "Remove unused Docker resources (containers, images, volumes, networks)",
+      "args": {
+        "id": {
+          "description": "Execution ID - prompts if not provided (ignored if --all or --agent used)",
+          "name": "id",
+          "required": false
+        }
+      },
+      "description": "Stop running execution(s)",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> WORK-001",
+        "<%= config.bin %> <%= command.id %> WORK-001 --force",
+        "<%= config.bin %> <%= command.id %>  # Interactive mode",
         "<%= config.bin %> <%= command.id %> --all",
-        "<%= config.bin %> <%= command.id %> --volumes",
-        "<%= config.bin %> <%= command.id %> --dry-run"
+        "<%= config.bin %> <%= command.id %> --all --force",
+        "<%= config.bin %> <%= command.id %> --agent altman"
       ],
       "flags": {
-        "force": {
-          "aliases": [
-            "yes",
-            "y"
-          ],
-          "char": "f",
-          "description": "Skip confirmation prompt",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "dry-run": {
-          "char": "d",
-          "description": "Show what would be removed without removing",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "all": {
-          "char": "a",
-          "description": "Remove all unused images, not just dangling ones",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "volumes": {
-          "description": "Also prune volumes (dangerous - data loss possible)",
-          "name": "volumes",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "json": {
           "description": "Output as JSON for AI agents/scripts",
           "name": "json",
@@ -3300,46 +3278,59 @@
           "name": "machine",
           "allowNo": false,
           "type": "boolean"
+        },
+        "force": {
+          "char": "f",
+          "description": "Force kill (SIGKILL instead of SIGTERM)",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "all": {
+          "description": "Stop all running executions",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "agent": {
+          "char": "a",
+          "description": "Stop all executions for a specific agent",
+          "name": "agent",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "docker:prune",
+      "id": "execution:stop",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "docker",
-        "prune.js"
+        "execution",
+        "stop.js"
       ]
     },
-    "docker:rebuild-cache": {
+    "execution:view": {
       "aliases": [],
-      "args": {},
-      "description": "Rebuild the shared pnpm store cache volume for fast agent installs",
+      "args": {
+        "id": {
+          "description": "Execution ID - prompts if not provided",
+          "name": "id",
+          "required": false
+        }
+      },
+      "description": "View details of a specific execution",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --force"
+        "<%= config.bin %> <%= command.id %> WORK-001",
+        "<%= config.bin %> <%= command.id %>  # Interactive mode"
       ],
       "flags": {
-        "force": {
-          "char": "f",
-          "description": "Delete and rebuild the cache even if it already exists",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "delete-only": {
-          "description": "Only delete the cache volume (next agent spawn rebuilds it)",
-          "name": "delete-only",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "json": {
           "description": "Output as JSON for AI agents/scripts",
           "name": "json",
@@ -3356,34 +3347,27 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "docker:rebuild-cache",
+      "id": "execution:view",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "docker",
-        "rebuild-cache.js"
+        "execution",
+        "view.js"
       ]
     },
-    "docker:restart": {
+    "docker:clean": {
       "aliases": [],
-      "args": {
-        "target": {
-          "description": "Execution ID (WORK-XXX), agent name, or container ID",
-          "name": "target",
-          "required": true
-        }
-      },
-      "description": "Restart a container (by execution ID, agent name, or container ID)",
+      "args": {},
+      "description": "Remove orphaned containers (containers without running agents)",
       "examples": [
-        "<%= config.bin %> <%= command.id %> WORK-001",
-        "<%= config.bin %> <%= command.id %> kalanick",
-        "<%= config.bin %> <%= command.id %> abc123 --force"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --force",
+        "<%= config.bin %> <%= command.id %> --dry-run"
       ],
       "flags": {
         "force": {
@@ -3397,14 +3381,19 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "time": {
-          "char": "t",
-          "description": "Seconds to wait before killing the container during stop",
-          "name": "time",
-          "default": 10,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would be removed without removing",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "all": {
+          "char": "a",
+          "description": "Remove all stopped devcontainers (not just orphaned)",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
         },
         "json": {
           "description": "Output as JSON for AI agents/scripts",
@@ -3422,7 +3411,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "docker:restart",
+      "id": "docker:clean",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
@@ -3433,23 +3422,26 @@
         "dist",
         "commands",
         "docker",
-        "restart.js"
+        "clean.js"
       ]
     },
-    "docker:shell": {
+    "docker": {
       "aliases": [],
-      "args": {
-        "target": {
-          "description": "Execution ID (WORK-XXX), agent name, or container ID",
-          "name": "target",
-          "required": true
-        }
-      },
-      "description": "Open a shell in a running container (by execution ID, agent name, or container ID)",
+      "args": {},
+      "description": "Manage Docker containers used by agents",
       "examples": [
-        "<%= config.bin %> <%= command.id %> WORK-001",
-        "<%= config.bin %> <%= command.id %> kalanick",
-        "<%= config.bin %> <%= command.id %> abc123 --shell /bin/bash"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> docker status",
+        "<%= config.bin %> docker list",
+        "<%= config.bin %> docker logs WORK-001",
+        "<%= config.bin %> docker start WORK-001",
+        "<%= config.bin %> docker stop kalanick",
+        "<%= config.bin %> docker shell WORK-001",
+        "<%= config.bin %> docker restart abc123",
+        "<%= config.bin %> docker sync",
+        "<%= config.bin %> docker rebuild-cache",
+        "<%= config.bin %> docker clean",
+        "<%= config.bin %> docker prune"
       ],
       "flags": {
         "json": {
@@ -3464,63 +3456,31 @@
           "name": "machine",
           "allowNo": false,
           "type": "boolean"
-        },
-        "shell": {
-          "char": "s",
-          "description": "Shell to use",
-          "name": "shell",
-          "default": "/bin/sh",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "user": {
-          "char": "u",
-          "description": "User to run as",
-          "name": "user",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "workdir": {
-          "char": "w",
-          "description": "Working directory inside the container",
-          "name": "workdir",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "docker:shell",
+      "id": "docker",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
         "docker",
-        "shell.js"
+        "index.js"
       ]
     },
-    "docker:start": {
+    "docker:list": {
       "aliases": [],
-      "args": {
-        "target": {
-          "description": "Execution ID (WORK-XXX), agent name, or container ID",
-          "name": "target",
-          "required": true
-        }
-      },
-      "description": "Start a stopped container (by execution ID, agent name, or container ID)",
+      "args": {},
+      "description": "Show Docker containers from agent_work table with status",
       "examples": [
-        "<%= config.bin %> <%= command.id %> WORK-001",
-        "<%= config.bin %> <%= command.id %> kalanick",
-        "<%= config.bin %> <%= command.id %> abc123"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --all",
+        "<%= config.bin %> <%= command.id %> --running"
       ],
       "flags": {
         "json": {
@@ -3536,17 +3496,24 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "attach": {
+        "all": {
           "char": "a",
-          "description": "Attach to container after starting",
-          "name": "attach",
+          "description": "Show all containers (including non-devcontainer)",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "running": {
+          "char": "r",
+          "description": "Only show running containers",
+          "name": "running",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "docker:start",
+      "id": "docker:list",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
@@ -3557,15 +3524,24 @@
         "dist",
         "commands",
         "docker",
-        "start.js"
+        "list.js"
       ]
     },
-    "docker:status": {
+    "docker:logs": {
       "aliases": [],
-      "args": {},
-      "description": "Check if Docker daemon is running",
+      "args": {
+        "target": {
+          "description": "Execution ID (WORK-XXX), agent name, or container ID",
+          "name": "target",
+          "required": true
+        }
+      },
+      "description": "View logs from a container (by execution ID, agent name, or container ID)",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %> WORK-001",
+        "<%= config.bin %> <%= command.id %> kalanick",
+        "<%= config.bin %> <%= command.id %> abc123 --follow",
+        "<%= config.bin %> <%= command.id %> WORK-001 --tail 100"
       ],
       "flags": {
         "json": {
@@ -3580,11 +3556,34 @@
           "name": "machine",
           "allowNo": false,
           "type": "boolean"
+        },
+        "follow": {
+          "char": "f",
+          "description": "Follow log output",
+          "name": "follow",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "tail": {
+          "char": "n",
+          "description": "Number of lines to show from the end",
+          "name": "tail",
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "timestamps": {
+          "char": "t",
+          "description": "Show timestamps",
+          "name": "timestamps",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "docker:status",
+      "id": "docker:logs",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
@@ -3595,23 +3594,18 @@
         "dist",
         "commands",
         "docker",
-        "status.js"
+        "logs.js"
       ]
     },
-    "docker:stop": {
+    "docker:prune": {
       "aliases": [],
-      "args": {
-        "target": {
-          "description": "Execution ID (WORK-XXX), agent name, or container ID",
-          "name": "target",
-          "required": true
-        }
-      },
-      "description": "Stop a running container (by execution ID, agent name, or container ID)",
+      "args": {},
+      "description": "Remove unused Docker resources (containers, images, volumes, networks)",
       "examples": [
-        "<%= config.bin %> <%= command.id %> WORK-001",
-        "<%= config.bin %> <%= command.id %> kalanick",
-        "<%= config.bin %> <%= command.id %> abc123 --force"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --all",
+        "<%= config.bin %> <%= command.id %> --volumes",
+        "<%= config.bin %> <%= command.id %> --dry-run"
       ],
       "flags": {
         "force": {
@@ -3625,14 +3619,25 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "time": {
-          "char": "t",
-          "description": "Seconds to wait before killing the container",
-          "name": "time",
-          "default": 10,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would be removed without removing",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "all": {
+          "char": "a",
+          "description": "Remove all unused images, not just dangling ones",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "volumes": {
+          "description": "Also prune volumes (dangerous - data loss possible)",
+          "name": "volumes",
+          "allowNo": false,
+          "type": "boolean"
         },
         "json": {
           "description": "Output as JSON for AI agents/scripts",
@@ -3650,7 +3655,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "docker:stop",
+      "id": "docker:prune",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
@@ -3661,17 +3666,31 @@
         "dist",
         "commands",
         "docker",
-        "stop.js"
+        "prune.js"
       ]
     },
-    "docker:sync": {
+    "docker:rebuild-cache": {
       "aliases": [],
       "args": {},
-      "description": "Sync container status from Docker into the database",
+      "description": "Rebuild the shared pnpm store cache volume for fast agent installs",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --force"
       ],
       "flags": {
+        "force": {
+          "char": "f",
+          "description": "Delete and rebuild the cache even if it already exists",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "delete-only": {
+          "description": "Only delete the cache volume (next agent spawn rebuilds it)",
+          "name": "delete-only",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "json": {
           "description": "Output as JSON for AI agents/scripts",
           "name": "json",
@@ -3688,7 +3707,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "docker:sync",
+      "id": "docker:rebuild-cache",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
@@ -3699,85 +3718,45 @@
         "dist",
         "commands",
         "docker",
-        "sync.js"
+        "rebuild-cache.js"
       ]
     },
-    "execution:config": {
+    "docker:restart": {
       "aliases": [],
-      "args": {},
-      "description": "View and update execution preferences",
+      "args": {
+        "target": {
+          "description": "Execution ID (WORK-XXX), agent name, or container ID",
+          "name": "target",
+          "required": true
+        }
+      },
+      "description": "Restart a container (by execution ID, agent name, or container ID)",
       "examples": [
-        "<%= config.bin %> execution config                    # Interactive menu",
-        "<%= config.bin %> execution config --json             # Output current config as JSON",
-        "<%= config.bin %> execution config --list             # Show all settings",
-        "<%= config.bin %> execution config --set defaultEnvironment host",
-        "<%= config.bin %> execution config --set outputMode interactive",
-        "<%= config.bin %> execution config --set permissionMode safe",
-        "<%= config.bin %> execution config --setting outputMode --json  # Show output mode choices"
+        "<%= config.bin %> <%= command.id %> WORK-001",
+        "<%= config.bin %> <%= command.id %> kalanick",
+        "<%= config.bin %> <%= command.id %> abc123 --force"
       ],
       "flags": {
-        "json": {
-          "description": "Output as JSON for AI agents/scripts",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "machine": {
-          "char": "m",
-          "description": "Output as JSON for AI agents/scripts",
-          "name": "machine",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "set": {
-          "char": "s",
-          "description": "Set a config value (format: key value)",
-          "name": "set",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "list": {
-          "char": "l",
-          "description": "List all configuration values",
-          "name": "list",
+        "force": {
+          "aliases": [
+            "yes",
+            "y"
+          ],
+          "char": "f",
+          "description": "Skip confirmation prompt",
+          "name": "force",
           "allowNo": false,
           "type": "boolean"
         },
-        "setting": {
-          "description": "Navigate to a specific setting prompt (for agent navigation)",
-          "name": "setting",
+        "time": {
+          "char": "t",
+          "description": "Seconds to wait before killing the container during stop",
+          "name": "time",
+          "default": 10,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "execution:config",
-      "pluginAlias": "@proletariat/cli",
-      "pluginName": "@proletariat/cli",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "execution",
-        "config.js"
-      ]
-    },
-    "execution": {
-      "aliases": [],
-      "args": {},
-      "description": "Single execution operations (view, logs, stop)",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> view WORK-001",
-        "<%= config.bin %> <%= command.id %> logs WORK-001",
-        "<%= config.bin %> <%= command.id %> stop WORK-001"
-      ],
-      "flags": {
+        },
         "json": {
           "description": "Output as JSON for AI agents/scripts",
           "name": "json",
@@ -3794,28 +3773,34 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "execution",
+      "id": "docker:restart",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
       "strict": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "execution",
-        "index.js"
+        "docker",
+        "restart.js"
       ]
     },
-    "execution:list": {
+    "docker:shell": {
       "aliases": [],
-      "args": {},
-      "description": "List running and recent executions",
+      "args": {
+        "target": {
+          "description": "Execution ID (WORK-XXX), agent name, or container ID",
+          "name": "target",
+          "required": true
+        }
+      },
+      "description": "Open a shell in a running container (by execution ID, agent name, or container ID)",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --status running",
-        "<%= config.bin %> <%= command.id %> --agent alice",
-        "<%= config.bin %> <%= command.id %> --limit 50"
+        "<%= config.bin %> <%= command.id %> WORK-001",
+        "<%= config.bin %> <%= command.id %> kalanick",
+        "<%= config.bin %> <%= command.id %> abc123 --shell /bin/bash"
       ],
       "flags": {
         "json": {
@@ -3831,34 +3816,27 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "status": {
+        "shell": {
           "char": "s",
-          "description": "Filter by status",
-          "name": "status",
+          "description": "Shell to use",
+          "name": "shell",
+          "default": "/bin/sh",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "starting",
-            "running",
-            "completed",
-            "failed",
-            "stopped"
-          ],
           "type": "option"
         },
-        "agent": {
-          "char": "a",
-          "description": "Filter by agent name",
-          "name": "agent",
+        "user": {
+          "char": "u",
+          "description": "User to run as",
+          "name": "user",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "limit": {
-          "char": "l",
-          "description": "Number of results",
-          "name": "limit",
-          "default": 20,
+        "workdir": {
+          "char": "w",
+          "description": "Working directory inside the container",
+          "name": "workdir",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3866,34 +3844,34 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "execution:list",
+      "id": "docker:shell",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
       "strict": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "execution",
-        "list.js"
+        "docker",
+        "shell.js"
       ]
     },
-    "execution:logs": {
+    "docker:start": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Execution ID - prompts if not provided",
-          "name": "id",
-          "required": false
+        "target": {
+          "description": "Execution ID (WORK-XXX), agent name, or container ID",
+          "name": "target",
+          "required": true
         }
       },
-      "description": "View execution logs",
+      "description": "Start a stopped container (by execution ID, agent name, or container ID)",
       "examples": [
         "<%= config.bin %> <%= command.id %> WORK-001",
-        "<%= config.bin %> <%= command.id %> WORK-001 --follow",
-        "<%= config.bin %> <%= command.id %> WORK-001 --tail 50",
-        "<%= config.bin %> <%= command.id %>  # Interactive mode"
+        "<%= config.bin %> <%= command.id %> kalanick",
+        "<%= config.bin %> <%= command.id %> abc123"
       ],
       "flags": {
         "json": {
@@ -3909,54 +3887,36 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "follow": {
-          "char": "f",
-          "description": "Stream logs in real-time",
-          "name": "follow",
+        "attach": {
+          "char": "a",
+          "description": "Attach to container after starting",
+          "name": "attach",
           "allowNo": false,
           "type": "boolean"
-        },
-        "tail": {
-          "char": "n",
-          "description": "Show last n lines",
-          "name": "tail",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "execution:logs",
+      "id": "docker:start",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
       "strict": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "execution",
-        "logs.js"
+        "docker",
+        "start.js"
       ]
     },
-    "execution:stop": {
+    "docker:status": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Execution ID - prompts if not provided (ignored if --all or --agent used)",
-          "name": "id",
-          "required": false
-        }
-      },
-      "description": "Stop running execution(s)",
+      "args": {},
+      "description": "Check if Docker daemon is running",
       "examples": [
-        "<%= config.bin %> <%= command.id %> WORK-001",
-        "<%= config.bin %> <%= command.id %> WORK-001 --force",
-        "<%= config.bin %> <%= command.id %>  # Interactive mode",
-        "<%= config.bin %> <%= command.id %> --all",
-        "<%= config.bin %> <%= command.id %> --all --force",
-        "<%= config.bin %> <%= command.id %> --agent altman"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
         "json": {
@@ -3971,59 +3931,60 @@
           "name": "machine",
           "allowNo": false,
           "type": "boolean"
-        },
-        "force": {
-          "char": "f",
-          "description": "Force kill (SIGKILL instead of SIGTERM)",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "all": {
-          "description": "Stop all running executions",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "agent": {
-          "char": "a",
-          "description": "Stop all executions for a specific agent",
-          "name": "agent",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "execution:stop",
+      "id": "docker:status",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
       "strict": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "execution",
-        "stop.js"
+        "docker",
+        "status.js"
       ]
     },
-    "execution:view": {
+    "docker:stop": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Execution ID - prompts if not provided",
-          "name": "id",
-          "required": false
+        "target": {
+          "description": "Execution ID (WORK-XXX), agent name, or container ID",
+          "name": "target",
+          "required": true
         }
       },
-      "description": "View details of a specific execution",
+      "description": "Stop a running container (by execution ID, agent name, or container ID)",
       "examples": [
         "<%= config.bin %> <%= command.id %> WORK-001",
-        "<%= config.bin %> <%= command.id %>  # Interactive mode"
+        "<%= config.bin %> <%= command.id %> kalanick",
+        "<%= config.bin %> <%= command.id %> abc123 --force"
       ],
       "flags": {
+        "force": {
+          "aliases": [
+            "yes",
+            "y"
+          ],
+          "char": "f",
+          "description": "Skip confirmation prompt",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "time": {
+          "char": "t",
+          "description": "Seconds to wait before killing the container",
+          "name": "time",
+          "default": 10,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "json": {
           "description": "Output as JSON for AI agents/scripts",
           "name": "json",
@@ -4040,17 +4001,56 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "execution:view",
+      "id": "docker:stop",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
       "strict": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "execution",
-        "view.js"
+        "docker",
+        "stop.js"
+      ]
+    },
+    "docker:sync": {
+      "aliases": [],
+      "args": {},
+      "description": "Sync container status from Docker into the database",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {
+        "json": {
+          "description": "Output as JSON for AI agents/scripts",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "machine": {
+          "char": "m",
+          "description": "Output as JSON for AI agents/scripts",
+          "name": "machine",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "docker:sync",
+      "pluginAlias": "@proletariat/cli",
+      "pluginName": "@proletariat/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "docker",
+        "sync.js"
       ]
     },
     "feedback": {
@@ -6843,6 +6843,99 @@
         "view.js"
       ]
     },
+    "run": {
+      "aliases": [],
+      "args": {
+        "task": {
+          "description": "Task description for the agent",
+          "name": "task",
+          "required": true
+        }
+      },
+      "description": "Spawn an agent to work on a task (works anywhere, no HQ required)",
+      "examples": [
+        "<%= config.bin %> run \"fix the login bug\"",
+        "<%= config.bin %> run --runner claude-code \"add dark mode\"",
+        "<%= config.bin %> run -d \"fix the bug\"",
+        "<%= config.bin %> run --runner codex \"add tests\""
+      ],
+      "flags": {
+        "json": {
+          "description": "Output as JSON for AI agents/scripts",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "machine": {
+          "char": "m",
+          "description": "Output as JSON for AI agents/scripts",
+          "name": "machine",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "runner": {
+          "char": "r",
+          "description": "Runner to use (claude-code, codex, pi)",
+          "name": "runner",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "detached": {
+          "char": "d",
+          "description": "Run in background (detached)",
+          "name": "detached",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "directory": {
+          "description": "Working directory (default: cwd)",
+          "name": "directory",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "permission-mode": {
+          "char": "p",
+          "description": "Permission mode (danger: skip prompts, safe: require approval)",
+          "name": "permission-mode",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "danger",
+            "safe"
+          ],
+          "type": "option"
+        },
+        "environment": {
+          "char": "e",
+          "description": "Environment to run in",
+          "name": "environment",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "host",
+            "docker",
+            "podman"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "run",
+      "pluginAlias": "@proletariat/cli",
+      "pluginName": "@proletariat/cli",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "run",
+        "index.js"
+      ]
+    },
     "shortcut:connect": {
       "aliases": [],
       "args": {},
@@ -8103,23 +8196,23 @@
         "logs.js"
       ]
     },
-    "run": {
+    "sync": {
       "aliases": [],
-      "args": {
-        "task": {
-          "description": "Task description for the agent",
-          "name": "task",
-          "required": true
-        }
-      },
-      "description": "Spawn an agent to work on a task (works anywhere, no HQ required)",
+      "args": {},
+      "description": "Reconcile ticket state with GitHub PR status",
       "examples": [
-        "<%= config.bin %> run \"fix the login bug\"",
-        "<%= config.bin %> run --runner claude-code \"add dark mode\"",
-        "<%= config.bin %> run -d \"fix the bug\"",
-        "<%= config.bin %> run --runner codex \"add tests\""
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --dry-run"
       ],
       "flags": {
+        "project": {
+          "char": "P",
+          "description": "Project ID (uses first project if only one exists)",
+          "name": "project",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "json": {
           "description": "Output as JSON for AI agents/scripts",
           "name": "json",
@@ -8133,109 +8226,16 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "runner": {
-          "char": "r",
-          "description": "Runner to use (claude-code, codex, pi)",
-          "name": "runner",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "detached": {
-          "char": "d",
-          "description": "Run in background (detached)",
-          "name": "detached",
+        "dry-run": {
+          "description": "Show what would change without applying",
+          "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
-        },
-        "directory": {
-          "description": "Working directory (default: cwd)",
-          "name": "directory",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "permission-mode": {
-          "char": "p",
-          "description": "Permission mode (danger: skip prompts, safe: require approval)",
-          "name": "permission-mode",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "danger",
-            "safe"
-          ],
-          "type": "option"
-        },
-        "environment": {
-          "char": "e",
-          "description": "Environment to run in",
-          "name": "environment",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "host",
-            "docker",
-            "podman"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "run",
-      "pluginAlias": "@proletariat/cli",
-      "pluginName": "@proletariat/cli",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "run",
-        "index.js"
-      ]
-    },
-    "sync": {
-      "aliases": [],
-      "args": {},
-      "description": "Reconcile ticket state with GitHub PR status",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --dry-run"
-      ],
-      "flags": {
-        "project": {
-          "char": "P",
-          "description": "Project ID (uses first project if only one exists)",
-          "name": "project",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "json": {
-          "description": "Output as JSON for AI agents/scripts",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "machine": {
-          "char": "m",
-          "description": "Output as JSON for AI agents/scripts",
-          "name": "machine",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "dry-run": {
-          "description": "Show what would change without applying",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "sync",
+      "id": "sync",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
@@ -8480,14 +8480,30 @@
         "stop.js"
       ]
     },
-    "telemetry:disable": {
+    "terminal:title": {
       "aliases": [],
-      "args": {},
-      "description": "Disable anonymous telemetry",
+      "args": {
+        "title": {
+          "description": "Title to set for the terminal tab/window",
+          "name": "title",
+          "required": false
+        }
+      },
+      "description": "Set the terminal tab/window title",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %> \"My Custom Name\"",
+        "<%= config.bin %> <%= command.id %>  # Interactive prompt",
+        "<%= config.bin %> <%= command.id %> --reset",
+        "<%= config.bin %> <%= command.id %> --machine  # JSON mode for agents"
       ],
       "flags": {
+        "reset": {
+          "char": "r",
+          "description": "Reset terminal title to default",
+          "name": "reset",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "json": {
           "description": "Output as JSON for AI agents/scripts",
           "name": "json",
@@ -8504,24 +8520,23 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "telemetry:disable",
+      "id": "terminal:title",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "telemetry",
-        "disable.js"
+        "terminal",
+        "title.js"
       ]
     },
-    "telemetry:enable": {
+    "telemetry:disable": {
       "aliases": [],
       "args": {},
-      "description": "Enable anonymous telemetry",
+      "description": "Disable anonymous telemetry",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
@@ -8542,7 +8557,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "telemetry:enable",
+      "id": "telemetry:disable",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
@@ -8553,16 +8568,15 @@
         "dist",
         "commands",
         "telemetry",
-        "enable.js"
+        "disable.js"
       ]
     },
-    "telemetry": {
+    "telemetry:enable": {
       "aliases": [],
       "args": {},
-      "description": "Show telemetry status",
+      "description": "Enable anonymous telemetry",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --json"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
         "json": {
@@ -8581,7 +8595,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "telemetry",
+      "id": "telemetry:enable",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
@@ -8592,15 +8606,16 @@
         "dist",
         "commands",
         "telemetry",
-        "index.js"
+        "enable.js"
       ]
     },
-    "telemetry:status": {
+    "telemetry": {
       "aliases": [],
       "args": {},
       "description": "Show telemetry status",
       "examples": [
-        "<%= config.bin %> telemetry status"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --json"
       ],
       "flags": {
         "json": {
@@ -8619,7 +8634,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "telemetry:status",
+      "id": "telemetry",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
@@ -8630,33 +8645,17 @@
         "dist",
         "commands",
         "telemetry",
-        "status.js"
+        "index.js"
       ]
     },
-    "terminal:title": {
+    "telemetry:status": {
       "aliases": [],
-      "args": {
-        "title": {
-          "description": "Title to set for the terminal tab/window",
-          "name": "title",
-          "required": false
-        }
-      },
-      "description": "Set the terminal tab/window title",
+      "args": {},
+      "description": "Show telemetry status",
       "examples": [
-        "<%= config.bin %> <%= command.id %> \"My Custom Name\"",
-        "<%= config.bin %> <%= command.id %>  # Interactive prompt",
-        "<%= config.bin %> <%= command.id %> --reset",
-        "<%= config.bin %> <%= command.id %> --machine  # JSON mode for agents"
+        "<%= config.bin %> telemetry status"
       ],
       "flags": {
-        "reset": {
-          "char": "r",
-          "description": "Reset terminal title to default",
-          "name": "reset",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "json": {
           "description": "Output as JSON for AI agents/scripts",
           "name": "json",
@@ -8673,17 +8672,18 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "terminal:title",
+      "id": "telemetry:status",
       "pluginAlias": "@proletariat/cli",
       "pluginName": "@proletariat/cli",
       "pluginType": "core",
       "strict": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "terminal",
-        "title.js"
+        "telemetry",
+        "status.js"
       ]
     },
     "theme:add-names": {
@@ -8919,30 +8919,32 @@
         "set.js"
       ]
     },
-    "tools:add": {
+    "ticket:create": {
       "aliases": [],
-      "args": {
-        "type": {
-          "description": "Tool type (mcp or cli)",
-          "name": "type",
-          "options": [
-            "mcp",
-            "cli"
-          ],
-          "required": true
-        },
-        "name": {
-          "description": "Tool name (unique identifier)",
-          "name": "name",
-          "required": true
-        }
-      },
-      "description": "Register an MCP server or CLI tool",
+      "args": {},
+      "description": "Create a new ticket (routes to Linear when configured, or local PMO)",
       "examples": [
-        "<%= config.bin %> tools add mcp arcade --url https://api.arcade.dev/mcp --auth ARCADE_API_KEY --description \"Arcade integrations\"",
-        "<%= config.bin %> tools add cli gh --command gh --detect \"which gh\" --install \"brew install gh\" --description \"GitHub CLI\""
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --title \"Fix login bug\" --column Backlog",
+        "<%= config.bin %> <%= command.id %> -t \"Add feature\" -c \"In Progress\" -p P1",
+        "<%= config.bin %> <%= command.id %> --project mobile-app -t \"New feature\"",
+        "<%= config.bin %> <%= command.id %> --epic EPIC-001 -t \"Implement auth flow\"",
+        "<%= config.bin %> <%= command.id %> --title \"My ticket\" --description-file ./ticket-desc.md",
+        "<%= config.bin %> <%= command.id %> --title \"My ticket\" --description-file -  # Read from stdin",
+        "<%= config.bin %> <%= command.id %> --json  # Output column choices as JSON",
+        "<%= config.bin %> <%= command.id %> --title \"Test\" -P PROJ-001 --dry-run --json  # Validate without creating",
+        "<%= config.bin %> <%= command.id %> --source linear -t \"Fix bug\" --team ENG",
+        "<%= config.bin %> <%= command.id %> --source pmo -t \"Local task\" -c Backlog"
       ],
       "flags": {
+        "project": {
+          "char": "P",
+          "description": "Project ID (uses first project if only one exists)",
+          "name": "project",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "json": {
           "description": "Output as JSON for AI agents/scripts",
           "name": "json",
@@ -8956,310 +8958,40 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "url": {
-          "description": "MCP server URL (for remote servers)",
-          "name": "url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "command": {
-          "description": "Command to run (MCP server command or CLI tool binary)",
-          "name": "command",
+        "title": {
+          "char": "t",
+          "description": "Ticket title [required for non-interactive]",
+          "name": "title",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "auth": {
-          "description": "Environment variable for authentication (e.g., ARCADE_API_KEY)",
-          "name": "auth",
+        "column": {
+          "char": "c",
+          "description": "Column to place the ticket in",
+          "name": "column",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "detect": {
-          "description": "Shell command to detect if CLI tool is installed",
-          "name": "detect",
+        "priority": {
+          "char": "p",
+          "description": "Ticket priority (uses workspace priority scale)",
+          "name": "priority",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "install": {
-          "description": "Shell command to install the CLI tool",
-          "name": "install",
+        "category": {
+          "description": "Ticket category (e.g., bug, feature, refactor)",
+          "name": "category",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "description": {
           "char": "d",
-          "description": "Human-readable description",
-          "name": "description",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "tools:add",
-      "pluginAlias": "@proletariat/cli",
-      "pluginName": "@proletariat/cli",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "tools",
-        "add.js"
-      ]
-    },
-    "tools:check": {
-      "aliases": [],
-      "args": {},
-      "description": "Verify all registered tools are available and healthy",
-      "examples": [
-        "<%= config.bin %> tools check",
-        "<%= config.bin %> tools check --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Output as JSON for AI agents/scripts",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "machine": {
-          "char": "m",
-          "description": "Output as JSON for AI agents/scripts",
-          "name": "machine",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "tools:check",
-      "pluginAlias": "@proletariat/cli",
-      "pluginName": "@proletariat/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "tools",
-        "check.js"
-      ]
-    },
-    "tools:detect": {
-      "aliases": [],
-      "args": {},
-      "description": "Auto-detect common CLI tools on the system and register them",
-      "examples": [
-        "<%= config.bin %> tools detect",
-        "<%= config.bin %> tools detect --auto",
-        "<%= config.bin %> tools detect --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Output as JSON for AI agents/scripts",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "machine": {
-          "char": "m",
-          "description": "Output as JSON for AI agents/scripts",
-          "name": "machine",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "auto": {
-          "description": "Automatically register all detected tools without prompting",
-          "name": "auto",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "tools:detect",
-      "pluginAlias": "@proletariat/cli",
-      "pluginName": "@proletariat/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "tools",
-        "detect.js"
-      ]
-    },
-    "tools": {
-      "aliases": [
-        "tools:list"
-      ],
-      "args": {},
-      "description": "Show all registered MCP servers and CLI tools",
-      "examples": [
-        "<%= config.bin %> tools",
-        "<%= config.bin %> tools --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Output as JSON for AI agents/scripts",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "machine": {
-          "char": "m",
-          "description": "Output as JSON for AI agents/scripts",
-          "name": "machine",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "tools",
-      "pluginAlias": "@proletariat/cli",
-      "pluginName": "@proletariat/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "tools",
-        "index.js"
-      ]
-    },
-    "tools:remove": {
-      "aliases": [],
-      "args": {
-        "name": {
-          "description": "Tool name to remove",
-          "name": "name",
-          "required": true
-        }
-      },
-      "description": "Remove a tool from the registry",
-      "examples": [
-        "<%= config.bin %> tools remove arcade",
-        "<%= config.bin %> tools remove ffmpeg"
-      ],
-      "flags": {
-        "json": {
-          "description": "Output as JSON for AI agents/scripts",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "machine": {
-          "char": "m",
-          "description": "Output as JSON for AI agents/scripts",
-          "name": "machine",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "tools:remove",
-      "pluginAlias": "@proletariat/cli",
-      "pluginName": "@proletariat/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "tools",
-        "remove.js"
-      ]
-    },
-    "ticket:create": {
-      "aliases": [],
-      "args": {},
-      "description": "Create a new ticket (routes to Linear when configured, or local PMO)",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --title \"Fix login bug\" --column Backlog",
-        "<%= config.bin %> <%= command.id %> -t \"Add feature\" -c \"In Progress\" -p P1",
-        "<%= config.bin %> <%= command.id %> --project mobile-app -t \"New feature\"",
-        "<%= config.bin %> <%= command.id %> --epic EPIC-001 -t \"Implement auth flow\"",
-        "<%= config.bin %> <%= command.id %> --title \"My ticket\" --description-file ./ticket-desc.md",
-        "<%= config.bin %> <%= command.id %> --title \"My ticket\" --description-file -  # Read from stdin",
-        "<%= config.bin %> <%= command.id %> --json  # Output column choices as JSON",
-        "<%= config.bin %> <%= command.id %> --title \"Test\" -P PROJ-001 --dry-run --json  # Validate without creating",
-        "<%= config.bin %> <%= command.id %> --source linear -t \"Fix bug\" --team ENG",
-        "<%= config.bin %> <%= command.id %> --source pmo -t \"Local task\" -c Backlog"
-      ],
-      "flags": {
-        "project": {
-          "char": "P",
-          "description": "Project ID (uses first project if only one exists)",
-          "name": "project",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "json": {
-          "description": "Output as JSON for AI agents/scripts",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "machine": {
-          "char": "m",
-          "description": "Output as JSON for AI agents/scripts",
-          "name": "machine",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "title": {
-          "char": "t",
-          "description": "Ticket title [required for non-interactive]",
-          "name": "title",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "column": {
-          "char": "c",
-          "description": "Column to place the ticket in",
-          "name": "column",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "priority": {
-          "char": "p",
-          "description": "Ticket priority (uses workspace priority scale)",
-          "name": "priority",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "category": {
-          "description": "Ticket category (e.g., bug, feature, refactor)",
-          "name": "category",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "char": "d",
-          "description": "Ticket description",
+          "description": "Ticket description",
           "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -10281,6 +10013,274 @@
         "sync.js"
       ]
     },
+    "tools:add": {
+      "aliases": [],
+      "args": {
+        "type": {
+          "description": "Tool type (mcp or cli)",
+          "name": "type",
+          "options": [
+            "mcp",
+            "cli"
+          ],
+          "required": true
+        },
+        "name": {
+          "description": "Tool name (unique identifier)",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Register an MCP server or CLI tool",
+      "examples": [
+        "<%= config.bin %> tools add mcp arcade --url https://api.arcade.dev/mcp --auth ARCADE_API_KEY --description \"Arcade integrations\"",
+        "<%= config.bin %> tools add cli gh --command gh --detect \"which gh\" --install \"brew install gh\" --description \"GitHub CLI\""
+      ],
+      "flags": {
+        "json": {
+          "description": "Output as JSON for AI agents/scripts",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "machine": {
+          "char": "m",
+          "description": "Output as JSON for AI agents/scripts",
+          "name": "machine",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "url": {
+          "description": "MCP server URL (for remote servers)",
+          "name": "url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "command": {
+          "description": "Command to run (MCP server command or CLI tool binary)",
+          "name": "command",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "auth": {
+          "description": "Environment variable for authentication (e.g., ARCADE_API_KEY)",
+          "name": "auth",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "detect": {
+          "description": "Shell command to detect if CLI tool is installed",
+          "name": "detect",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "install": {
+          "description": "Shell command to install the CLI tool",
+          "name": "install",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "char": "d",
+          "description": "Human-readable description",
+          "name": "description",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "tools:add",
+      "pluginAlias": "@proletariat/cli",
+      "pluginName": "@proletariat/cli",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "tools",
+        "add.js"
+      ]
+    },
+    "tools:check": {
+      "aliases": [],
+      "args": {},
+      "description": "Verify all registered tools are available and healthy",
+      "examples": [
+        "<%= config.bin %> tools check",
+        "<%= config.bin %> tools check --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Output as JSON for AI agents/scripts",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "machine": {
+          "char": "m",
+          "description": "Output as JSON for AI agents/scripts",
+          "name": "machine",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "tools:check",
+      "pluginAlias": "@proletariat/cli",
+      "pluginName": "@proletariat/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "tools",
+        "check.js"
+      ]
+    },
+    "tools:detect": {
+      "aliases": [],
+      "args": {},
+      "description": "Auto-detect common CLI tools on the system and register them",
+      "examples": [
+        "<%= config.bin %> tools detect",
+        "<%= config.bin %> tools detect --auto",
+        "<%= config.bin %> tools detect --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Output as JSON for AI agents/scripts",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "machine": {
+          "char": "m",
+          "description": "Output as JSON for AI agents/scripts",
+          "name": "machine",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "auto": {
+          "description": "Automatically register all detected tools without prompting",
+          "name": "auto",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "tools:detect",
+      "pluginAlias": "@proletariat/cli",
+      "pluginName": "@proletariat/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "tools",
+        "detect.js"
+      ]
+    },
+    "tools": {
+      "aliases": [
+        "tools:list"
+      ],
+      "args": {},
+      "description": "Show all registered MCP servers and CLI tools",
+      "examples": [
+        "<%= config.bin %> tools",
+        "<%= config.bin %> tools --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Output as JSON for AI agents/scripts",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "machine": {
+          "char": "m",
+          "description": "Output as JSON for AI agents/scripts",
+          "name": "machine",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "tools",
+      "pluginAlias": "@proletariat/cli",
+      "pluginName": "@proletariat/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "tools",
+        "index.js"
+      ]
+    },
+    "tools:remove": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "Tool name to remove",
+          "name": "name",
+          "required": true
+        }
+      },
+      "description": "Remove a tool from the registry",
+      "examples": [
+        "<%= config.bin %> tools remove arcade",
+        "<%= config.bin %> tools remove ffmpeg"
+      ],
+      "flags": {
+        "json": {
+          "description": "Output as JSON for AI agents/scripts",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "machine": {
+          "char": "m",
+          "description": "Output as JSON for AI agents/scripts",
+          "name": "machine",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "tools:remove",
+      "pluginAlias": "@proletariat/cli",
+      "pluginName": "@proletariat/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "tools",
+        "remove.js"
+      ]
+    },
     "version:bump": {
       "aliases": [],
       "args": {
@@ -13913,5 +13913,5 @@
       ]
     }
   },
-  "version": "0.3.102"
+  "version": "0.3.103"
 }