@rulemetric/cli 0.18.1 → 0.20.0

package/oclif.manifest.json

@@ -937,6 +937,212 @@
         "list.js"
       ]
     },
+    "experiments:enroll": {
+      "aliases": [],
+      "args": {},
+      "description": "Submit a fresh work request to an eligible project experiment",
+      "examples": [
+        "<%= config.bin %> experiments enroll --project /repo --family parser-repair --prompt-file task.txt"
+      ],
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "project": {
+          "char": "p",
+          "description": "Project path (defaults to current directory)",
+          "name": "project",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "family": {
+          "description": "Task family shown by the waiting experiment",
+          "name": "family",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "prompt-file": {
+          "description": "UTF-8 file containing a real, fresh work request",
+          "name": "prompt-file",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "model": {
+          "description": "Optional model constraint; must match the experiment pin",
+          "name": "model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "experiments:enroll",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "experiments",
+        "enroll.js"
+      ]
+    },
+    "experiments:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List experiments with execution, metric finding, and application separately",
+      "examples": [
+        "<%= config.bin %> experiments list",
+        "<%= config.bin %> experiments list --all"
+      ],
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "project": {
+          "char": "p",
+          "description": "Project path (defaults to current directory)",
+          "name": "project",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "all": {
+          "description": "Every project",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "experiments:list",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "experiments",
+        "list.js"
+      ]
+    },
+    "experiments:reuse": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Completed source experiment UUID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Run selected previously measured fixture tasks with a new bounded exploratory budget",
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "task": {
+          "description": "Source task ID to reuse (repeat for multiple tasks)",
+          "name": "task",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "reason": {
+          "description": "Why this additional exploratory execution is useful (at least 20 characters)",
+          "name": "reason",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "request-id": {
+          "description": "Explicit UUID for a new budget; identical arguments otherwise recover the same request",
+          "name": "request-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "experiments:reuse",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "experiments",
+        "reuse.js"
+      ]
+    },
+    "gateway:ensure": {
+      "aliases": [],
+      "args": {},
+      "description": "Ensure the gateway proxy is running (called by hooks, not for direct use)",
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "gateway:ensure",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "gateway",
+        "ensure.js"
+      ]
+    },
     "evals:agent": {
       "aliases": [],
       "args": {},
@@ -980,11 +1186,9 @@
           "required": true
         }
       },
-      "description": "Run evals in a loop until the effect verdict is statistically powered (§6f auto-run-to-power)",
+      "description": "Retired adaptive loop; use evals run for one bounded experiment",
       "examples": [
-        "<%= config.bin %> evals auto-run <target-id>            # preview (cost + plan)",
-        "<%= config.bin %> evals auto-run <target-id> --yes      # run until powered / budget",
-        "<%= config.bin %> evals auto-run <target-id> --yes --max-runs 120 --batch-parallel 4"
+        "<%= config.bin %> evals run <target-id>"
       ],
       "flags": {
         "api-url": {
@@ -1127,9 +1331,9 @@
           "required": true
         }
       },
-      "description": "Blind A/B comparison between two eval target versions",
+      "description": "Retired blind comparison; use evals run for recorded task outcomes",
       "examples": [
-        "<%= config.bin %> evals compare <target-a> <target-b>"
+        "<%= config.bin %> evals run <target-id>"
       ],
       "flags": {
         "api-url": {
@@ -1254,10 +1458,9 @@
           "required": true
         }
       },
-      "description": "Optimize eval target description for better triggering accuracy",
+      "description": "Retired optimization workflow; use canonical experiments",
       "examples": [
-        "<%= config.bin %> evals optimize-description <target-id>",
-        "<%= config.bin %> evals optimize-description <target-id> --queries 10"
+        "<%= config.bin %> evals run <target-id>"
       ],
       "flags": {
         "api-url": {
@@ -1342,10 +1545,9 @@
           "required": true
         }
       },
-      "description": "Iteratively optimize eval target content using eval results as feedback",
+      "description": "Retired optimization workflow; use canonical experiments",
       "examples": [
-        "<%= config.bin %> evals optimize <target-id>",
-        "<%= config.bin %> evals optimize <target-id> --auto --max-iterations 3"
+        "<%= config.bin %> evals run <target-id>"
       ],
       "flags": {
         "api-url": {
@@ -1482,7 +1684,7 @@
           "required": true
         }
       },
-      "description": "Run evals against a target, optionally grade results, and post to API",
+      "description": "Queue an experiment against a target using the configured worker",
       "examples": [
         "<%= config.bin %> evals run <target-id>",
         "<%= config.bin %> evals run <target-id> --parallel 3 --runs-per-eval 2",
@@ -1671,43 +1873,30 @@
         "validate-judge.js"
       ]
     },
-    "experiments:list": {
+    "hooks:emit-instructions": {
       "aliases": [],
       "args": {},
-      "description": "Show instructions under randomised test and what each sample supports",
-      "examples": [
-        "<%= config.bin %> experiments list",
-        "<%= config.bin %> experiments list --project /path/to/project",
-        "<%= config.bin %> experiments list --all"
-      ],
+      "description": "Print a synthetic instruction snapshot (on-disk instruction files) as JSON for zero-proxy instruction linking",
       "flags": {
-        "api-url": {
-          "description": "Override API base URL",
-          "env": "RULEMETRIC_API_URL",
-          "hidden": true,
-          "name": "api-url",
+        "project-dir": {
+          "description": "Project directory to scan (defaults to cwd)",
+          "name": "project-dir",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "project": {
-          "char": "p",
-          "description": "Project path (defaults to current directory)",
-          "name": "project",
+        "tool": {
+          "description": "Hook tool id whose instruction files to read (claude_code, codex, copilot_agent, copilot_cli, vscode_copilot)",
+          "name": "tool",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "all": {
-          "description": "Every project, not just this one",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
+      "hidden": true,
       "hiddenAliases": [],
-      "id": "experiments:list",
+      "id": "hooks:emit-instructions",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -1717,14 +1906,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "experiments",
-        "list.js"
+        "hooks",
+        "emit-instructions.js"
       ]
     },
-    "gateway:ensure": {
+    "hooks:install": {
       "aliases": [],
       "args": {},
-      "description": "Ensure the gateway proxy is running (called by hooks, not for direct use)",
+      "description": "Install session tracking hooks and context capture proxy for Claude Code",
+      "examples": [
+        "<%= config.bin %> hooks install",
+        "<%= config.bin %> hooks install --global",
+        "<%= config.bin %> hooks install --no-proxy"
+      ],
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -1734,117 +1928,43 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "no-proxy": {
+          "description": "Skip proxy/gateway configuration (hooks only)",
+          "name": "no-proxy",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "project-dir": {
+          "description": "Project directory to install hooks in (defaults to cwd)",
+          "name": "project-dir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "user-hooks": {
+          "description": "Write user-level Cursor/Antigravity hooks (~/.cursor, ~/.gemini). Required for Cursor capture — its traffic bypasses the proxy.",
+          "name": "user-hooks",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "global": {
+          "char": "g",
+          "description": "Install hooks globally (~/.claude/settings.json) so all projects are tracked",
+          "name": "global",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "statusline-usage": {
+          "description": "Install the statusline shim so Claude Code pushes live rate_limits on every refresh (makes /usage rings update in real time without needing the proxy)",
+          "name": "statusline-usage",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
-      "hidden": true,
       "hiddenAliases": [],
-      "id": "gateway:ensure",
-      "pluginAlias": "@rulemetric/cli",
-      "pluginName": "@rulemetric/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "gateway",
-        "ensure.js"
-      ]
-    },
-    "hooks:emit-instructions": {
-      "aliases": [],
-      "args": {},
-      "description": "Print a synthetic instruction snapshot (on-disk instruction files) as JSON for zero-proxy instruction linking",
-      "flags": {
-        "project-dir": {
-          "description": "Project directory to scan (defaults to cwd)",
-          "name": "project-dir",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "tool": {
-          "description": "Hook tool id whose instruction files to read (claude_code, codex, copilot_agent, copilot_cli, vscode_copilot)",
-          "name": "tool",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hidden": true,
-      "hiddenAliases": [],
-      "id": "hooks:emit-instructions",
-      "pluginAlias": "@rulemetric/cli",
-      "pluginName": "@rulemetric/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "hooks",
-        "emit-instructions.js"
-      ]
-    },
-    "hooks:install": {
-      "aliases": [],
-      "args": {},
-      "description": "Install session tracking hooks and context capture proxy for Claude Code",
-      "examples": [
-        "<%= config.bin %> hooks install",
-        "<%= config.bin %> hooks install --global",
-        "<%= config.bin %> hooks install --no-proxy"
-      ],
-      "flags": {
-        "api-url": {
-          "description": "Override API base URL",
-          "env": "RULEMETRIC_API_URL",
-          "hidden": true,
-          "name": "api-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "no-proxy": {
-          "description": "Skip proxy/gateway configuration (hooks only)",
-          "name": "no-proxy",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "project-dir": {
-          "description": "Project directory to install hooks in (defaults to cwd)",
-          "name": "project-dir",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "user-hooks": {
-          "description": "Write user-level Cursor/Antigravity hooks (~/.cursor, ~/.gemini). Required for Cursor capture — its traffic bypasses the proxy.",
-          "name": "user-hooks",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "global": {
-          "char": "g",
-          "description": "Install hooks globally (~/.claude/settings.json) so all projects are tracked",
-          "name": "global",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "statusline-usage": {
-          "description": "Install the statusline shim so Claude Code pushes live rate_limits on every refresh (makes /usage rings update in real time without needing the proxy)",
-          "name": "statusline-usage",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "hooks:install",
+      "id": "hooks:install",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2608,10 +2728,16 @@
         "versions.js"
       ]
     },
-    "local:down": {
+    "proxy:env": {
       "aliases": [],
       "args": {},
-      "description": "Stop the local RuleMetric server and database stack. Data is preserved (restart with `rulemetric local up`); use --delete-data to also wipe the local database.",
+      "description": "Print shell env vars to route any client through the RuleMetric proxy",
+      "examples": [
+        "<%= config.bin %> proxy env",
+        "<%= config.bin %> proxy env --shell fish",
+        "eval \"$(rulemetric proxy env)\"",
+        "rulemetric proxy env --python"
+      ],
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -2622,16 +2748,48 @@
           "multiple": false,
           "type": "option"
         },
-        "delete-data": {
-          "description": "Also delete the local database volumes (irreversible)",
-          "name": "delete-data",
+        "shell": {
+          "char": "s",
+          "description": "Shell format (posix, fish, powershell)",
+          "name": "shell",
+          "default": "posix",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "posix",
+            "fish",
+            "powershell"
+          ],
+          "type": "option"
+        },
+        "python": {
+          "description": "Include Python-specific env vars (REQUESTS_CA_BUNDLE, SSL_CERT_FILE)",
+          "name": "python",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "node": {
+          "description": "Include Node.js-specific env vars (NODE_EXTRA_CA_CERTS)",
+          "name": "node",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "all": {
+          "description": "Include env vars for all runtimes",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "vscode": {
+          "description": "Output VS Code settings.json snippet for Copilot proxy",
+          "name": "vscode",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "local:down",
+      "id": "proxy:env",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2641,18 +2799,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "local",
-        "down.js"
+        "proxy",
+        "env.js"
       ]
     },
-    "local:up": {
+    "proxy:logs": {
       "aliases": [],
       "args": {},
-      "description": "Run RuleMetric fully locally: start a local Supabase stack (Docker), apply migrations, and serve the API + dashboard from the @rulemetric/local runtime — all data on this machine, zero cloud contact. Downloads the runtime package on first run.",
+      "description": "View context capture proxy logs",
       "examples": [
-        "<%= config.bin %> local up --email you@example.com --password <pw>",
-        "<%= config.bin %> local up --port 3000",
-        "<%= config.bin %> local up --foreground"
+        "<%= config.bin %> proxy logs",
+        "<%= config.bin %> proxy logs --follow",
+        "<%= config.bin %> proxy logs --lines 50"
       ],
       "flags": {
         "api-url": {
@@ -2664,47 +2822,26 @@
           "multiple": false,
           "type": "option"
         },
-        "port": {
-          "char": "p",
-          "description": "Local API + dashboard port",
-          "name": "port",
-          "default": 3000,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "email": {
-          "char": "e",
-          "description": "Create the first user with this email (with --password)",
-          "name": "email",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "follow": {
+          "char": "f",
+          "description": "Follow log output (like tail -f)",
+          "name": "follow",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "password": {
-          "description": "Password for the first user (min 8 chars)",
-          "name": "password",
+        "lines": {
+          "char": "n",
+          "description": "Number of lines to show",
+          "name": "lines",
+          "default": 30,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "foreground": {
-          "description": "Run the server in this terminal instead of installing a launchd service (works on any OS; skips user provisioning)",
-          "name": "foreground",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Skip the runtime-download confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "local:up",
+      "id": "proxy:logs",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2714,16 +2851,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "local",
-        "up.js"
+        "proxy",
+        "logs.js"
       ]
     },
-    "org:current": {
+    "proxy:restart": {
       "aliases": [],
       "args": {},
-      "description": "Show the current active organization",
+      "description": "Restart the context capture proxy (stop + start)",
       "examples": [
-        "<%= config.bin %> org current"
+        "<%= config.bin %> proxy restart"
       ],
       "flags": {
         "api-url": {
@@ -2734,11 +2871,26 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "port": {
+          "char": "p",
+          "description": "Proxy listen port",
+          "name": "port",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "docker": {
+          "char": "d",
+          "description": "Run in Docker mode",
+          "name": "docker",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "org:current",
+      "id": "proxy:restart",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2748,16 +2900,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "org",
-        "current.js"
+        "proxy",
+        "restart.js"
       ]
     },
-    "org:list": {
+    "proxy:setup": {
       "aliases": [],
       "args": {},
-      "description": "List organizations the current user is a member of",
+      "description": "Set up context capture proxy (installs mitmproxy, configures shell)",
       "examples": [
-        "<%= config.bin %> org list"
+        "<%= config.bin %> proxy setup",
+        "<%= config.bin %> proxy setup --shell zsh",
+        "<%= config.bin %> proxy setup --check"
       ],
       "flags": {
         "api-url": {
@@ -2768,11 +2922,39 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
+        },
+        "shell": {
+          "description": "Shell to configure (auto-detected if omitted)",
+          "name": "shell",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "zsh",
+            "bash",
+            "fish",
+            "powershell"
+          ],
+          "type": "option"
+        },
+        "port": {
+          "char": "p",
+          "description": "Proxy listen port",
+          "name": "port",
+          "default": 8787,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "check": {
+          "description": "Only check prerequisites, do not install anything",
+          "name": "check",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "org:list",
+      "id": "proxy:setup",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2782,23 +2964,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "org",
-        "list.js"
+        "proxy",
+        "setup.js"
       ]
     },
-    "org:switch": {
+    "proxy:start": {
       "aliases": [],
-      "args": {
-        "slug": {
-          "description": "Organization slug to switch to",
-          "name": "slug",
-          "required": false
-        }
-      },
-      "description": "Switch the active organization",
+      "args": {},
+      "description": "Start context capture proxy",
       "examples": [
-        "<%= config.bin %> org switch acme",
-        "<%= config.bin %> org switch --clear"
+        "<%= config.bin %> proxy start",
+        "<%= config.bin %> proxy start --docker",
+        "<%= config.bin %> proxy start --port 9090",
+        "<%= config.bin %> proxy start --web"
       ],
       "flags": {
         "api-url": {
@@ -2810,16 +2988,44 @@
           "multiple": false,
           "type": "option"
         },
-        "clear": {
-          "description": "Clear the active organization (personal mode)",
-          "name": "clear",
+        "port": {
+          "char": "p",
+          "description": "Proxy listen port",
+          "name": "port",
+          "default": 8788,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "docker": {
+          "char": "d",
+          "description": "Run proxy in Docker (no local mitmproxy needed)",
+          "name": "docker",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "web": {
+          "description": "Launch mitmweb debug UI instead of mitmdump (local mode only)",
+          "name": "web",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-checks": {
+          "description": "Skip prerequisite checks",
+          "name": "skip-checks",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "build": {
+          "description": "Force rebuild Docker image",
+          "name": "build",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "org:switch",
+      "id": "proxy:start",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2829,8 +3035,76 @@
       "relativePath": [
         "dist",
         "commands",
-        "org",
-        "switch.js"
+        "proxy",
+        "start.js"
+      ]
+    },
+    "proxy:status": {
+      "aliases": [],
+      "args": {},
+      "description": "Check gateway and context capture proxy status",
+      "examples": [
+        "<%= config.bin %> proxy status"
+      ],
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "proxy:status",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "proxy",
+        "status.js"
+      ]
+    },
+    "proxy:stop": {
+      "aliases": [],
+      "args": {},
+      "description": "Stop the context capture proxy",
+      "examples": [
+        "<%= config.bin %> proxy stop"
+      ],
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "proxy:stop",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "proxy",
+        "stop.js"
       ]
     },
     "packs:add-instruction": {
@@ -3181,15 +3455,13 @@
         "remove-instruction.js"
       ]
     },
-    "proxy:env": {
+    "research:backfill": {
       "aliases": [],
       "args": {},
-      "description": "Print shell env vars to route any client through the RuleMetric proxy",
+      "description": "Scan every ~/.claude/projects transcript for past rate-limit (429) events and POST them as observations. Opt-in seed for the usage-research dataset — forward-only tail is the default capture path.",
       "examples": [
-        "<%= config.bin %> proxy env",
-        "<%= config.bin %> proxy env --shell fish",
-        "eval \"$(rulemetric proxy env)\"",
-        "rulemetric proxy env --python"
+        "<%= config.bin %> research backfill",
+        "<%= config.bin %> research backfill --claude-dir /custom/.claude --dry-run"
       ],
       "flags": {
         "api-url": {
@@ -3201,48 +3473,24 @@
           "multiple": false,
           "type": "option"
         },
-        "shell": {
-          "char": "s",
-          "description": "Shell format (posix, fish, powershell)",
-          "name": "shell",
-          "default": "posix",
+        "claude-dir": {
+          "description": "Override the Claude Code projects directory (defaults to ~/.claude)",
+          "name": "claude-dir",
+          "noCacheDefault": true,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "posix",
-            "fish",
-            "powershell"
-          ],
           "type": "option"
         },
-        "python": {
-          "description": "Include Python-specific env vars (REQUESTS_CA_BUNDLE, SSL_CERT_FILE)",
-          "name": "python",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "node": {
-          "description": "Include Node.js-specific env vars (NODE_EXTRA_CA_CERTS)",
-          "name": "node",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "all": {
-          "description": "Include env vars for all runtimes",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "vscode": {
-          "description": "Output VS Code settings.json snippet for Copilot proxy",
-          "name": "vscode",
+        "dry-run": {
+          "description": "Print observation count without POSTing",
+          "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "proxy:env",
+      "id": "research:backfill",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3252,18 +3500,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "env.js"
+        "research",
+        "backfill.js"
       ]
     },
-    "proxy:logs": {
+    "research:resume-scoped-outcomes": {
       "aliases": [],
       "args": {},
-      "description": "View context capture proxy logs",
+      "description": "Finish uploading scoped headless outcomes whose receipt was preserved locally after the actor exited but whose capture or verification upload failed. Never re-runs the actor or re-measures the repository; ships the stored receipt and exact transcript only.",
       "examples": [
-        "<%= config.bin %> proxy logs",
-        "<%= config.bin %> proxy logs --follow",
-        "<%= config.bin %> proxy logs --lines 50"
+        "<%= config.bin %> research resume-scoped-outcomes",
+        "<%= config.bin %> research resume-scoped-outcomes --list"
       ],
       "flags": {
         "api-url": {
@@ -3275,26 +3522,17 @@
           "multiple": false,
           "type": "option"
         },
-        "follow": {
-          "char": "f",
-          "description": "Follow log output (like tail -f)",
-          "name": "follow",
+        "list": {
+          "description": "Show the outcome store without uploading anything",
+          "name": "list",
           "allowNo": false,
           "type": "boolean"
-        },
-        "lines": {
-          "char": "n",
-          "description": "Number of lines to show",
-          "name": "lines",
-          "default": 30,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
+      "hidden": true,
       "hiddenAliases": [],
-      "id": "proxy:logs",
+      "id": "research:resume-scoped-outcomes",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3304,17 +3542,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "logs.js"
+        "research",
+        "resume-scoped-outcomes.js"
       ]
     },
-    "proxy:restart": {
+    "research:tail-transcript": {
       "aliases": [],
-      "args": {},
-      "description": "Restart the context capture proxy (stop + start)",
-      "examples": [
-        "<%= config.bin %> proxy restart"
-      ],
+      "args": {
+        "transcript": {
+          "description": "Absolute path to a Claude Code .jsonl transcript",
+          "name": "transcript",
+          "required": true
+        }
+      },
+      "description": "Read new lines from a Claude Code transcript since the last cached offset, POST any 429 events, and persist the new offset. Invoked by the session-end hook — safe to re-run.",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3325,25 +3566,17 @@
           "multiple": false,
           "type": "option"
         },
-        "port": {
-          "char": "p",
-          "description": "Proxy listen port",
-          "name": "port",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "docker": {
-          "char": "d",
-          "description": "Run in Docker mode",
-          "name": "docker",
+        "no-post": {
+          "description": "Parse and advance the offset without POSTing (debug)",
+          "name": "no-post",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
+      "hidden": true,
       "hiddenAliases": [],
-      "id": "proxy:restart",
+      "id": "research:tail-transcript",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3353,18 +3586,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "restart.js"
+        "research",
+        "tail-transcript.js"
       ]
     },
-    "proxy:setup": {
+    "service:install": {
       "aliases": [],
       "args": {},
-      "description": "Set up context capture proxy (installs mitmproxy, configures shell)",
+      "description": "Install RuleMetric services. Default (in a repo checkout): API + worker + gateway + capture proxy as launchd agents. With --worker-only: just the job worker, targeting the globally-installed CLI — no repo, no build (works from `npm i -g @rulemetric/cli`, macOS launchd or Linux systemd).",
       "examples": [
-        "<%= config.bin %> proxy setup",
-        "<%= config.bin %> proxy setup --shell zsh",
-        "<%= config.bin %> proxy setup --check"
+        "<%= config.bin %> service install",
+        "<%= config.bin %> service install --port 3000",
+        "<%= config.bin %> service install --skip-build",
+        "<%= config.bin %> service install --no-proxy",
+        "<%= config.bin %> service install --worker-only"
       ],
       "flags": {
         "api-url": {
@@ -3376,38 +3611,53 @@
           "multiple": false,
           "type": "option"
         },
-        "shell": {
-          "description": "Shell to configure (auto-detected if omitted)",
-          "name": "shell",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "zsh",
-            "bash",
-            "fish",
-            "powershell"
-          ],
-          "type": "option"
-        },
         "port": {
           "char": "p",
-          "description": "Proxy listen port",
+          "description": "API server port",
           "name": "port",
-          "default": 8787,
+          "default": 3000,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "check": {
-          "description": "Only check prerequisites, do not install anything",
-          "name": "check",
+        "force": {
+          "char": "f",
+          "description": "Overwrite existing service configuration and reclaim conflicting ports",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-build": {
+          "description": "Skip the pre-install workspace build (API/web/cli dist must already exist)",
+          "name": "skip-build",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-proxy": {
+          "description": "Skip gateway + mitmproxy plists (just install API + worker)",
+          "name": "no-proxy",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "auto-update": {
+          "dependsOn": [
+            "worker-only"
+          ],
+          "description": "Opt this machine into automatic stable CLI updates after active worker jobs finish (requires --worker-only)",
+          "name": "auto-update",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "worker-only": {
+          "description": "Install ONLY the job worker as a persistent service, targeting the globally-installed CLI (no repo checkout, no build, no API/gateway/proxy). Sources auth from ~/.config/rulemetric/env. macOS (launchd) + Linux (systemd --user).",
+          "name": "worker-only",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "proxy:setup",
+      "id": "service:install",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3417,20 +3667,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "setup.js"
+        "service",
+        "install.js"
       ]
     },
-    "proxy:start": {
+    "service:status": {
       "aliases": [],
       "args": {},
-      "description": "Start context capture proxy",
-      "examples": [
-        "<%= config.bin %> proxy start",
-        "<%= config.bin %> proxy start --docker",
-        "<%= config.bin %> proxy start --port 9090",
-        "<%= config.bin %> proxy start --web"
-      ],
+      "description": "Check the status of installed RuleMetric services (launchd on macOS; systemd --user worker on Linux)",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3440,45 +3684,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "port": {
-          "char": "p",
-          "description": "Proxy listen port",
-          "name": "port",
-          "default": 8788,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "docker": {
-          "char": "d",
-          "description": "Run proxy in Docker (no local mitmproxy needed)",
-          "name": "docker",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "web": {
-          "description": "Launch mitmweb debug UI instead of mitmdump (local mode only)",
-          "name": "web",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "skip-checks": {
-          "description": "Skip prerequisite checks",
-          "name": "skip-checks",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "build": {
-          "description": "Force rebuild Docker image",
-          "name": "build",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "proxy:start",
+      "id": "service:status",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3488,17 +3698,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "start.js"
+        "service",
+        "status.js"
       ]
     },
-    "proxy:status": {
+    "service:uninstall": {
       "aliases": [],
       "args": {},
-      "description": "Check gateway and context capture proxy status",
-      "examples": [
-        "<%= config.bin %> proxy status"
-      ],
+      "description": "Remove RuleMetric services (macOS launchd: API/worker/gateway/proxy; Linux: the --worker-only systemd unit)",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3512,7 +3719,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "proxy:status",
+      "id": "service:uninstall",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3522,16 +3729,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "status.js"
+        "service",
+        "uninstall.js"
       ]
     },
-    "proxy:stop": {
+    "service:updates": {
       "aliases": [],
       "args": {},
-      "description": "Stop the context capture proxy",
+      "description": "Show or change automatic worker updates on this machine (off by default)",
       "examples": [
-        "<%= config.bin %> proxy stop"
+        "<%= config.bin %> service updates",
+        "<%= config.bin %> service updates --enable",
+        "<%= config.bin %> service updates --disable"
       ],
       "flags": {
         "api-url": {
@@ -3542,11 +3751,29 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "enable": {
+          "description": "Install stable npm releases automatically after active jobs finish",
+          "exclusive": [
+            "disable"
+          ],
+          "name": "enable",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "disable": {
+          "description": "Stop future automatic updates",
+          "exclusive": [
+            "enable"
+          ],
+          "name": "disable",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "proxy:stop",
+      "id": "service:updates",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3556,17 +3783,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "stop.js"
+        "service",
+        "updates.js"
       ]
     },
-    "research:backfill": {
+    "org:current": {
       "aliases": [],
       "args": {},
-      "description": "Scan every ~/.claude/projects transcript for past rate-limit (429) events and POST them as observations. Opt-in seed for the usage-research dataset — forward-only tail is the default capture path.",
+      "description": "Show the current active organization",
       "examples": [
-        "<%= config.bin %> research backfill",
-        "<%= config.bin %> research backfill --claude-dir /custom/.claude --dry-run"
+        "<%= config.bin %> org current"
       ],
       "flags": {
         "api-url": {
@@ -3577,25 +3803,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "claude-dir": {
-          "description": "Override the Claude Code projects directory (defaults to ~/.claude)",
-          "name": "claude-dir",
-          "noCacheDefault": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "dry-run": {
-          "description": "Print observation count without POSTing",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "research:backfill",
+      "id": "org:current",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3605,17 +3817,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "research",
-        "backfill.js"
+        "org",
+        "current.js"
       ]
     },
-    "research:resume-scoped-outcomes": {
+    "org:list": {
       "aliases": [],
       "args": {},
-      "description": "Finish uploading scoped headless outcomes whose receipt was preserved locally after the actor exited but whose capture or verification upload failed. Never re-runs the actor or re-measures the repository; ships the stored receipt and exact transcript only.",
+      "description": "List organizations the current user is a member of",
       "examples": [
-        "<%= config.bin %> research resume-scoped-outcomes",
-        "<%= config.bin %> research resume-scoped-outcomes --list"
+        "<%= config.bin %> org list"
       ],
       "flags": {
         "api-url": {
@@ -3626,18 +3837,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "list": {
-          "description": "Show the outcome store without uploading anything",
-          "name": "list",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
-      "hidden": true,
       "hiddenAliases": [],
-      "id": "research:resume-scoped-outcomes",
+      "id": "org:list",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3647,20 +3851,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "research",
-        "resume-scoped-outcomes.js"
+        "org",
+        "list.js"
       ]
     },
-    "research:tail-transcript": {
+    "org:switch": {
       "aliases": [],
       "args": {
-        "transcript": {
-          "description": "Absolute path to a Claude Code .jsonl transcript",
-          "name": "transcript",
-          "required": true
+        "slug": {
+          "description": "Organization slug to switch to",
+          "name": "slug",
+          "required": false
         }
       },
-      "description": "Read new lines from a Claude Code transcript since the last cached offset, POST any 429 events, and persist the new offset. Invoked by the session-end hook — safe to re-run.",
+      "description": "Switch the active organization",
+      "examples": [
+        "<%= config.bin %> org switch acme",
+        "<%= config.bin %> org switch --clear"
+      ],
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3671,17 +3879,16 @@
           "multiple": false,
           "type": "option"
         },
-        "no-post": {
-          "description": "Parse and advance the offset without POSTing (debug)",
-          "name": "no-post",
+        "clear": {
+          "description": "Clear the active organization (personal mode)",
+          "name": "clear",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
-      "hidden": true,
       "hiddenAliases": [],
-      "id": "research:tail-transcript",
+      "id": "org:switch",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3691,21 +3898,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "research",
-        "tail-transcript.js"
+        "org",
+        "switch.js"
       ]
     },
-    "service:install": {
+    "local:down": {
       "aliases": [],
       "args": {},
-      "description": "Install RuleMetric services. Default (in a repo checkout): API + worker + gateway + capture proxy as launchd agents. With --worker-only: just the job worker, targeting the globally-installed CLI — no repo, no build (works from `npm i -g @rulemetric/cli`, macOS launchd or Linux systemd).",
-      "examples": [
-        "<%= config.bin %> service install",
-        "<%= config.bin %> service install --port 3000",
-        "<%= config.bin %> service install --skip-build",
-        "<%= config.bin %> service install --no-proxy",
-        "<%= config.bin %> service install --worker-only"
-      ],
+      "description": "Stop the local RuleMetric server and database stack. Data is preserved (restart with `rulemetric local up`); use --delete-data to also wipe the local database.",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3716,44 +3916,16 @@
           "multiple": false,
           "type": "option"
         },
-        "port": {
-          "char": "p",
-          "description": "API server port",
-          "name": "port",
-          "default": 3000,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "force": {
-          "char": "f",
-          "description": "Overwrite existing service configuration and reclaim conflicting ports",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "skip-build": {
-          "description": "Skip the pre-install workspace build (API/web/cli dist must already exist)",
-          "name": "skip-build",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "no-proxy": {
-          "description": "Skip gateway + mitmproxy plists (just install API + worker)",
-          "name": "no-proxy",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "worker-only": {
-          "description": "Install ONLY the job worker as a persistent service, targeting the globally-installed CLI (no repo checkout, no build, no API/gateway/proxy). Sources auth from ~/.config/rulemetric/env. macOS (launchd) + Linux (systemd --user).",
-          "name": "worker-only",
+        "delete-data": {
+          "description": "Also delete the local database volumes (irreversible)",
+          "name": "delete-data",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "service:install",
+      "id": "local:down",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3763,14 +3935,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "service",
-        "install.js"
+        "local",
+        "down.js"
       ]
     },
-    "service:status": {
+    "local:up": {
       "aliases": [],
       "args": {},
-      "description": "Check the status of installed RuleMetric services (launchd on macOS; systemd --user worker on Linux)",
+      "description": "Run RuleMetric fully locally: start a local Supabase stack (Docker), apply migrations, and serve the API + dashboard from the @rulemetric/local runtime — all data on this machine, zero cloud contact. Downloads the runtime package on first run.",
+      "examples": [
+        "<%= config.bin %> local up --email you@example.com --password <pw>",
+        "<%= config.bin %> local up --port 3000",
+        "<%= config.bin %> local up --foreground"
+      ],
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3780,11 +3957,48 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "port": {
+          "char": "p",
+          "description": "Local API + dashboard port",
+          "name": "port",
+          "default": 3000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "email": {
+          "char": "e",
+          "description": "Create the first user with this email (with --password)",
+          "name": "email",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "password": {
+          "description": "Password for the first user (min 8 chars)",
+          "name": "password",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "foreground": {
+          "description": "Run the server in this terminal instead of installing a launchd service (works on any OS; skips user provisioning)",
+          "name": "foreground",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip the runtime-download confirmation",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "service:status",
+      "id": "local:up",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3794,14 +4008,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "service",
-        "status.js"
+        "local",
+        "up.js"
       ]
     },
-    "service:uninstall": {
+    "skills:export-approved": {
       "aliases": [],
       "args": {},
-      "description": "Remove RuleMetric services (macOS launchd: API/worker/gateway/proxy; Linux: the --worker-only systemd unit)",
+      "description": "Export approved community submissions as community-skills.json for registry merge",
+      "examples": [
+        "<%= config.bin %> skills export-approved",
+        "<%= config.bin %> skills export-approved --output ./community-skills.json"
+      ],
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3811,11 +4029,19 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "output": {
+          "description": "Output file path",
+          "name": "output",
+          "default": "packages/skills-registry/community-skills.json",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "service:uninstall",
+      "id": "skills:export-approved",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3825,22 +4051,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "service",
-        "uninstall.js"
+        "skills",
+        "export-approved.js"
       ]
     },
-    "sessions:analyze": {
+    "skills:install": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Session ID",
+          "description": "Skill ID to install",
           "name": "id",
           "required": true
         }
       },
-      "description": "Trigger AI analysis on a session",
+      "description": "Install a skill from the registry into your project",
       "examples": [
-        "<%= config.bin %> sessions analyze <session-id>"
+        "<%= config.bin %> skills install tdd-workflow",
+        "<%= config.bin %> skills install tdd-workflow --preview",
+        "<%= config.bin %> skills install tdd-workflow --force"
       ],
       "flags": {
         "api-url": {
@@ -3851,85 +4079,64 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "sessions:analyze",
-      "pluginAlias": "@rulemetric/cli",
-      "pluginName": "@rulemetric/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "sessions",
-        "analyze.js"
-      ]
-    },
-    "sessions:delete": {
-      "aliases": [],
-      "args": {
-        "ids": {
-          "description": "Session id(s) to delete",
-          "name": "ids",
-          "required": false
-        }
-      },
-      "description": "Permanently delete captured sessions and everything stored with them (events, context snapshots, offloaded blobs)",
-      "examples": [
-        "<%= config.bin %> sessions delete 4f9d…",
-        "<%= config.bin %> sessions delete 4f9d… 8a21…",
-        "<%= config.bin %> sessions delete --project /work/client-a --yes"
-      ],
-      "flags": {
-        "api-url": {
-          "description": "Override API base URL",
-          "env": "RULEMETRIC_API_URL",
+        },
+        "tool": {
+          "description": "Deprecated and ignored — skills install to every agent path at once",
           "hidden": true,
-          "name": "api-url",
+          "name": "tool",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "claude_code",
+            "cursor",
+            "copilot"
+          ],
           "type": "option"
         },
-        "project": {
-          "description": "Delete every session captured under this project path (use with --yes).",
-          "name": "project",
+        "preview": {
+          "description": "Preview content without writing",
+          "name": "preview",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dir": {
+          "description": "Project directory",
+          "name": "dir",
+          "default": ".",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "description": "Skip the confirmation prompt. Required for --project in non-interactive use.",
-          "name": "yes",
+        "force": {
+          "description": "Replace an existing skill directory at the Claude Code path",
+          "name": "force",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions:delete",
+      "id": "skills:install",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
-      "strict": false,
+      "strict": true,
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "delete.js"
+        "skills",
+        "install.js"
       ]
     },
-    "sessions:end": {
+    "skills:list": {
       "aliases": [],
       "args": {},
-      "description": "End the active capture session",
+      "description": "List skills in the registry",
       "examples": [
-        "<%= config.bin %> sessions end"
+        "<%= config.bin %> skills list",
+        "<%= config.bin %> skills list --stats"
       ],
       "flags": {
         "api-url": {
@@ -3940,11 +4147,25 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "stats": {
+          "description": "Show registry statistics",
+          "name": "stats",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Max skills to show",
+          "name": "limit",
+          "default": 30,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions:end",
+      "id": "skills:list",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3954,23 +4175,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "end.js"
+        "skills",
+        "list.js"
       ]
     },
-    "sessions:import": {
+    "skills:publish": {
       "aliases": [],
       "args": {
-        "path": {
-          "description": "Path to session file",
-          "name": "path",
+        "file": {
+          "description": "Path to skill file (.md)",
+          "name": "file",
           "required": true
         }
       },
-      "description": "Import a session file (JSONL, JSON)",
+      "description": "Submit a skill file to the RuleMetric skills registry",
       "examples": [
-        "<%= config.bin %> sessions import ~/.claude/projects/my-project/session-abc.jsonl",
-        "<%= config.bin %> sessions import ./copilot-export.json --tool vscode_copilot"
+        "<%= config.bin %> skills publish ./my-skill.md",
+        "<%= config.bin %> skills publish ./my-skill.md --category workflow --tool claude_code"
       ],
       "flags": {
         "api-url": {
@@ -3982,18 +4203,69 @@
           "multiple": false,
           "type": "option"
         },
-        "tool": {
-          "description": "Override tool detection (claude_code, cursor, vscode_copilot)",
-          "name": "tool",
+        "name": {
+          "description": "Skill name (defaults to filename)",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "sessions:import",
-      "pluginAlias": "@rulemetric/cli",
+        },
+        "description": {
+          "description": "One-line description",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "category": {
+          "description": "Skill category",
+          "name": "category",
+          "default": "other",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "workflow",
+            "language",
+            "framework",
+            "tool",
+            "security",
+            "testing",
+            "architecture",
+            "devops",
+            "documentation",
+            "performance",
+            "other"
+          ],
+          "type": "option"
+        },
+        "tool": {
+          "description": "Primary tool this skill targets",
+          "name": "tool",
+          "default": "universal",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "claude_code",
+            "cursor",
+            "copilot",
+            "windsurf",
+            "universal"
+          ],
+          "type": "option"
+        },
+        "tags": {
+          "description": "Comma-separated tags",
+          "name": "tags",
+          "default": "",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "skills:publish",
+      "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
       "strict": true,
@@ -4002,18 +4274,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "import.js"
+        "skills",
+        "publish.js"
       ]
     },
-    "sessions:list": {
+    "skills:search": {
       "aliases": [],
-      "args": {},
-      "description": "List captured sessions",
+      "args": {
+        "query": {
+          "description": "Search term",
+          "name": "query",
+          "required": false
+        }
+      },
+      "description": "Search the community skills registry",
       "examples": [
-        "<%= config.bin %> sessions list",
-        "<%= config.bin %> sessions list --tool claude_code",
-        "<%= config.bin %> sessions list --tool codex"
+        "<%= config.bin %> skills search \"tdd\"",
+        "<%= config.bin %> skills search --tool cursor --category testing",
+        "<%= config.bin %> skills search --language python"
       ],
       "flags": {
         "api-url": {
@@ -4026,10 +4304,51 @@
           "type": "option"
         },
         "tool": {
-          "description": "Filter by tool (claude_code, cursor, vscode_copilot, copilot_agent, rulemetric_mcp, codex, pi, opencode, antigravity)",
+          "description": "Filter by tool",
           "name": "tool",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "claude_code",
+            "cursor",
+            "copilot",
+            "windsurf",
+            "cline",
+            "universal"
+          ],
+          "type": "option"
+        },
+        "category": {
+          "description": "Filter by category",
+          "name": "category",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "workflow",
+            "language",
+            "framework",
+            "tool",
+            "security",
+            "testing",
+            "architecture",
+            "devops",
+            "documentation",
+            "performance"
+          ],
+          "type": "option"
+        },
+        "language": {
+          "description": "Filter by programming language",
+          "name": "language",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "framework": {
+          "description": "Filter by framework",
+          "name": "framework",
+          "hasDynamicHelp": false,
+          "multiple": false,
           "type": "option"
         },
         "limit": {
@@ -4043,7 +4362,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions:list",
+      "id": "skills:search",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -4053,18 +4372,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "list.js"
+        "skills",
+        "search.js"
       ]
     },
-    "sessions:start": {
+    "skills:update": {
       "aliases": [],
       "args": {},
-      "description": "Start a capture session for any LLM provider (Cortex, Groq, etc.)",
+      "description": "Fetch latest skills from GitHub sources and update local registry",
       "examples": [
-        "<%= config.bin %> sessions start --tool cortex",
-        "<%= config.bin %> sessions start --tool groq --project-dir /path/to/project",
-        "eval \"$(rulemetric proxy env --python)\" && rulemetric sessions start --tool cortex"
+        "<%= config.bin %> skills update",
+        "<%= config.bin %> skills update --all"
       ],
       "flags": {
         "api-url": {
@@ -4076,27 +4394,16 @@
           "multiple": false,
           "type": "option"
         },
-        "tool": {
-          "char": "t",
-          "description": "LLM provider or tool name (e.g., cortex, groq, deepseek, custom_app)",
-          "name": "tool",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "project-dir": {
-          "char": "d",
-          "description": "Project directory (defaults to cwd)",
-          "name": "project-dir",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "all": {
+          "description": "Include Tier 2 (niche) sources",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions:start",
+      "id": "skills:update",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -4106,17 +4413,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "start.js"
+        "skills",
+        "update.js"
       ]
     },
-    "skills:export-approved": {
+    "sessions:analyze": {
       "aliases": [],
-      "args": {},
-      "description": "Export approved community submissions as community-skills.json for registry merge",
+      "args": {
+        "id": {
+          "description": "Session ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Trigger AI analysis on a session",
       "examples": [
-        "<%= config.bin %> skills export-approved",
-        "<%= config.bin %> skills export-approved --output ./community-skills.json"
+        "<%= config.bin %> sessions analyze <session-id>"
       ],
       "flags": {
         "api-url": {
@@ -4127,19 +4439,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "output": {
-          "description": "Output file path",
-          "name": "output",
-          "default": "packages/skills-registry/community-skills.json",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "skills:export-approved",
+      "id": "sessions:analyze",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -4149,24 +4453,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "skills",
-        "export-approved.js"
+        "sessions",
+        "analyze.js"
       ]
     },
-    "skills:install": {
+    "sessions:delete": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Skill ID to install",
-          "name": "id",
-          "required": true
+        "ids": {
+          "description": "Session id(s) to delete",
+          "name": "ids",
+          "required": false
         }
       },
-      "description": "Install a skill from the registry into your project",
+      "description": "Permanently delete captured sessions and everything stored with them (events, context snapshots, offloaded blobs)",
       "examples": [
-        "<%= config.bin %> skills install tdd-workflow",
-        "<%= config.bin %> skills install tdd-workflow --preview",
-        "<%= config.bin %> skills install tdd-workflow --force"
+        "<%= config.bin %> sessions delete 4f9d…",
+        "<%= config.bin %> sessions delete 4f9d… 8a21…",
+        "<%= config.bin %> sessions delete --project /work/client-a --yes"
       ],
       "flags": {
         "api-url": {
@@ -4178,63 +4482,42 @@
           "multiple": false,
           "type": "option"
         },
-        "tool": {
-          "description": "Deprecated and ignored — skills install to every agent path at once",
-          "hidden": true,
-          "name": "tool",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "claude_code",
-            "cursor",
-            "copilot"
-          ],
-          "type": "option"
-        },
-        "preview": {
-          "description": "Preview content without writing",
-          "name": "preview",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "dir": {
-          "description": "Project directory",
-          "name": "dir",
-          "default": ".",
+        "project": {
+          "description": "Delete every session captured under this project path (use with --yes).",
+          "name": "project",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "force": {
-          "description": "Replace an existing skill directory at the Claude Code path",
-          "name": "force",
+        "yes": {
+          "description": "Skip the confirmation prompt. Required for --project in non-interactive use.",
+          "name": "yes",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "skills:install",
+      "id": "sessions:delete",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
-      "strict": true,
+      "strict": false,
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "skills",
-        "install.js"
+        "sessions",
+        "delete.js"
       ]
     },
-    "skills:list": {
+    "sessions:end": {
       "aliases": [],
       "args": {},
-      "description": "List skills in the registry",
+      "description": "End the active capture session",
       "examples": [
-        "<%= config.bin %> skills list",
-        "<%= config.bin %> skills list --stats"
+        "<%= config.bin %> sessions end"
       ],
       "flags": {
         "api-url": {
@@ -4245,25 +4528,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "stats": {
-          "description": "Show registry statistics",
-          "name": "stats",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "limit": {
-          "description": "Max skills to show",
-          "name": "limit",
-          "default": 30,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "skills:list",
+      "id": "sessions:end",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -4273,23 +4542,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "skills",
-        "list.js"
+        "sessions",
+        "end.js"
       ]
     },
-    "skills:publish": {
+    "sessions:import": {
       "aliases": [],
       "args": {
-        "file": {
-          "description": "Path to skill file (.md)",
-          "name": "file",
+        "path": {
+          "description": "Path to session file",
+          "name": "path",
           "required": true
         }
       },
-      "description": "Submit a skill file to the RuleMetric skills registry",
+      "description": "Import a session file (JSONL, JSON)",
       "examples": [
-        "<%= config.bin %> skills publish ./my-skill.md",
-        "<%= config.bin %> skills publish ./my-skill.md --category workflow --tool claude_code"
+        "<%= config.bin %> sessions import ~/.claude/projects/my-project/session-abc.jsonl",
+        "<%= config.bin %> sessions import ./copilot-export.json --tool vscode_copilot"
       ],
       "flags": {
         "api-url": {
@@ -4301,60 +4570,9 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "Skill name (defaults to filename)",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "description": "One-line description",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "category": {
-          "description": "Skill category",
-          "name": "category",
-          "default": "other",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "workflow",
-            "language",
-            "framework",
-            "tool",
-            "security",
-            "testing",
-            "architecture",
-            "devops",
-            "documentation",
-            "performance",
-            "other"
-          ],
-          "type": "option"
-        },
         "tool": {
-          "description": "Primary tool this skill targets",
+          "description": "Override tool detection (claude_code, cursor, vscode_copilot)",
           "name": "tool",
-          "default": "universal",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "claude_code",
-            "cursor",
-            "copilot",
-            "windsurf",
-            "universal"
-          ],
-          "type": "option"
-        },
-        "tags": {
-          "description": "Comma-separated tags",
-          "name": "tags",
-          "default": "",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4362,7 +4580,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "skills:publish",
+      "id": "sessions:import",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -4372,24 +4590,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "skills",
-        "publish.js"
+        "sessions",
+        "import.js"
       ]
     },
-    "skills:search": {
+    "sessions:list": {
       "aliases": [],
-      "args": {
-        "query": {
-          "description": "Search term",
-          "name": "query",
-          "required": false
-        }
-      },
-      "description": "Search the community skills registry",
+      "args": {},
+      "description": "List captured sessions",
       "examples": [
-        "<%= config.bin %> skills search \"tdd\"",
-        "<%= config.bin %> skills search --tool cursor --category testing",
-        "<%= config.bin %> skills search --language python"
+        "<%= config.bin %> sessions list",
+        "<%= config.bin %> sessions list --tool claude_code",
+        "<%= config.bin %> sessions list --tool codex"
       ],
       "flags": {
         "api-url": {
@@ -4402,51 +4614,10 @@
           "type": "option"
         },
         "tool": {
-          "description": "Filter by tool",
+          "description": "Filter by tool (claude_code, cursor, vscode_copilot, copilot_agent, rulemetric_mcp, codex, pi, opencode, antigravity)",
           "name": "tool",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "claude_code",
-            "cursor",
-            "copilot",
-            "windsurf",
-            "cline",
-            "universal"
-          ],
-          "type": "option"
-        },
-        "category": {
-          "description": "Filter by category",
-          "name": "category",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "workflow",
-            "language",
-            "framework",
-            "tool",
-            "security",
-            "testing",
-            "architecture",
-            "devops",
-            "documentation",
-            "performance"
-          ],
-          "type": "option"
-        },
-        "language": {
-          "description": "Filter by programming language",
-          "name": "language",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "framework": {
-          "description": "Filter by framework",
-          "name": "framework",
-          "hasDynamicHelp": false,
-          "multiple": false,
           "type": "option"
         },
         "limit": {
@@ -4460,7 +4631,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "skills:search",
+      "id": "sessions:list",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -4470,17 +4641,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "skills",
-        "search.js"
+        "sessions",
+        "list.js"
       ]
     },
-    "skills:update": {
+    "sessions:start": {
       "aliases": [],
       "args": {},
-      "description": "Fetch latest skills from GitHub sources and update local registry",
+      "description": "Start a capture session for any LLM provider (Cortex, Groq, etc.)",
       "examples": [
-        "<%= config.bin %> skills update",
-        "<%= config.bin %> skills update --all"
+        "<%= config.bin %> sessions start --tool cortex",
+        "<%= config.bin %> sessions start --tool groq --project-dir /path/to/project",
+        "eval \"$(rulemetric proxy env --python)\" && rulemetric sessions start --tool cortex"
       ],
       "flags": {
         "api-url": {
@@ -4492,16 +4664,27 @@
           "multiple": false,
           "type": "option"
         },
-        "all": {
-          "description": "Include Tier 2 (niche) sources",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
+        "tool": {
+          "char": "t",
+          "description": "LLM provider or tool name (e.g., cortex, groq, deepseek, custom_app)",
+          "name": "tool",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "project-dir": {
+          "char": "d",
+          "description": "Project directory (defaults to cwd)",
+          "name": "project-dir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "skills:update",
+      "id": "sessions:start",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -4511,8 +4694,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "skills",
-        "update.js"
+        "sessions",
+        "start.js"
       ]
     },
     "suggestions:accept": {
@@ -4815,5 +4998,5 @@
       ]
     }
   },
-  "version": "0.18.1"
+  "version": "0.20.0"
 }