fix(plugin-cli): rename --aggregator flag to --registry-url

.changeset/plugin-cli-registry-url-flag.md

@@ -0,0 +1,17 @@
+---
+"@emdash-cms/plugin-cli": patch
+---
+
+Renames the `--aggregator` flag on `search` and `info` to `--registry-url` for consistency with the `EMDASH_REGISTRY_URL` env var and the rest of the user-facing surface. Internally the override still selects the aggregator service to query — the rename only affects what users type.
+
+Old:
+
+```sh
+emdash-plugin search "image" --aggregator https://registry.example.com
+```
+
+New:
+
+```sh
+emdash-plugin search "image" --registry-url https://registry.example.com
+```

packages/plugin-cli/README.md

@@ -34,7 +34,7 @@ emdash-plugin search <query>                 Free-text search
 emdash-plugin info <handle-or-did> <slug>    Show package details
 ```
 
-All commands accept `--json`. Discovery commands accept `--aggregator <url>` (or `EMDASH_REGISTRY_URL`).
+The non-interactive output commands (`whoami`, `validate`, `search`, `info`, `login`, `publish`) accept `--json` for machine-readable output. Discovery commands (`search`, `info`) accept `--registry-url <url>` (or `EMDASH_REGISTRY_URL`).
 
 ## Authoring
 

packages/plugin-cli/src/commands/info.ts

@@ -35,17 +35,17 @@ export const infoCommand = defineCommand({
 			description: "Package slug",
 			required: true,
 		},
-		aggregator: {
+		"registry-url": {
 			type: "string",
-			description: "Override aggregator URL",
+			description: "Override registry URL",
 		},
 		json: {
 			type: "boolean",
 			description: "Output as JSON",
 		},
 	},
 	async run({ args }) {
-		const aggregatorUrl = resolveAggregatorUrl(args.aggregator);
+		const aggregatorUrl = resolveAggregatorUrl(args["registry-url"]);
 		const client = new DiscoveryClient({ aggregatorUrl });
 
 		let result;

packages/plugin-cli/src/commands/search.ts

@@ -36,17 +36,17 @@ export const searchCommand = defineCommand({
 			description:
 				"Continuation cursor from a previous search result (printed at the end when more results exist)",
 		},
-		aggregator: {
+		"registry-url": {
 			type: "string",
-			description: "Override aggregator URL (defaults to EMDASH_REGISTRY_URL or experimental host)",
+			description: "Override registry URL (defaults to EMDASH_REGISTRY_URL or experimental host)",
 		},
 		json: {
 			type: "boolean",
 			description: "Output as JSON",
 		},
 	},
 	async run({ args }) {
-		const aggregatorUrl = resolveAggregatorUrl(args.aggregator);
+		const aggregatorUrl = resolveAggregatorUrl(args["registry-url"]);
 		const limit = clamp(parseInt(args.limit, 10) || 25, 1, 100);
 
 		const client = new DiscoveryClient({ aggregatorUrl });

packages/plugin-cli/src/config.ts

@@ -2,7 +2,7 @@
  * Shared config for the registry CLI.
  *
  * The aggregator URL defaults to the experimental host but can be overridden
- * per-invocation via `--aggregator <url>` or by the `EMDASH_REGISTRY_URL`
+ * per-invocation via `--registry-url <url>` or by the `EMDASH_REGISTRY_URL`
  * env var. We resolve in that order, falling back to the default.
  *
  * EXPERIMENTAL: the default host is provisional. It will be retired and