there's nothing to see here

.changeset/modern-bats-pick.md

@@ -0,0 +1,4 @@
+---
+---
+
+Internal: split easter-egg / extra commands into a new private `@clerk/cli-extras` workspace package and add a hidden `clerk clerk-bird` command. No effect on the published `clerk` binary's documented surface area, so no release is needed.

package.json

@@ -11,10 +11,10 @@
     "test:e2e": "bun run scripts/run-tests.ts --pattern 'test/e2e/*.test.ts' --retries 1",
     "test:e2e:op": "bun run scripts/run-e2e-op.ts",
     "e2e:refresh-fixtures": "bun run scripts/refresh-e2e-fixtures.ts",
-    "typecheck": "bun run --filter @clerk/cli-core typecheck && tsc --noEmit -p scripts/tsconfig.json",
-    "lint": "bun run --filter @clerk/cli-core lint && oxlint -c .oxlintrc.json scripts/",
-    "format": "bun run --filter @clerk/cli-core format && oxfmt --write scripts/",
-    "format:check": "bun run --filter @clerk/cli-core format:check && oxfmt --check scripts/",
+    "typecheck": "bun run --filter './packages/*' typecheck && tsc --noEmit -p scripts/tsconfig.json",
+    "lint": "bun run --filter './packages/*' lint && oxlint -c .oxlintrc.json scripts/",
+    "format": "bun run --filter './packages/*' format && oxfmt --write scripts/",
+    "format:check": "bun run --filter './packages/*' format:check && oxfmt --check scripts/",
     "check:patches": "bun run scripts/check-patches.ts",
     "build:compile": "bun run --filter @clerk/cli-core build:compile",
     "version-packages": "bun changeset version",

packages/cli-core/package.json

@@ -16,6 +16,7 @@
     "format:check": "oxfmt --check src/"
   },
   "dependencies": {
+    "@clerk/cli-extras": "workspace:*",
     "@commander-js/extra-typings": "^14.0.0",
     "@inquirer/ansi": "^2.0.5",
     "@inquirer/core": "^11.1.9",

packages/cli-core/src/cli-program.ts

@@ -44,6 +44,7 @@ import { log } from "./lib/log.ts";
 import { maybeNotifyUpdate, getCurrentVersion } from "./lib/update-check.ts";
 import { update } from "./commands/update/index.ts";
 import { isClerkSkillInstalled } from "./lib/skill-detection.ts";
+import { registerExtras } from "@clerk/cli-extras";
 
 export function createProgram() {
   const program = new Command()
@@ -564,6 +565,8 @@ Tutorial — enable completions for your shell:
     ])
     .action(update);
 
+  registerExtras(program);
+
   return program;
 }
 

packages/extras/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@clerk/cli-extras",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "lint": "oxlint src/",
+    "format": "oxfmt --write src/",
+    "format:check": "oxfmt --check src/"
+  },
+  "dependencies": {
+    "@commander-js/extra-typings": "^14.0.0",
+    "commander": "^14.0.3"
+  }
+}