@theholocron/cli 2.0.0-alpha.72 → 2.0.0-alpha.74

package/dist/cli.mjs

@@ -483,9 +483,12 @@ var PluginLoader = class {
 			throw new LoaderError(`failed to import \`${tuple.packageName}\` for capability \`${key}\`: ${err instanceof Error ? err.message : String(err)}`);
 		});
 		if (isPluginModule(mod)) {
+			const effectiveToken = this.context.cliTokens?.[tuple.provider] ?? this.context.cliToken;
 			const factory = mod.createPlugin({
 				...this.projectDefaults(),
 				...this.context,
+				...effectiveToken !== void 0 ? { cliToken: effectiveToken } : {},
+				cliTokens: void 0,
 				...tuple.options
 			}).capabilities[key];
 			if (typeof factory !== "function") throw new LoaderError(`\`${tuple.packageName}\` does not implement the \`${key}\` capability`);
@@ -913,7 +916,7 @@ var lint_default$1 = "name: Lint\n\non: # yamllint disable-line rule:truthy\n  w
 var release_default$1 = "name: Release\n\n# Semantic-release with OIDC Trusted Publishing — no NPM_TOKEN required.\n# The calling repo must have a .releaserc.json that configures branches,\n# plugins, and any publish options. npm@11+ is installed to support OIDC.\n\non: # yamllint disable-line rule:truthy\n  workflow_call:\n    inputs:\n      run-build:\n        description: Run `pnpm build` before releasing\n        type: boolean\n        required: false\n        default: true\n    secrets:\n      SYNC_TOKEN:\n        description: >\n          Optional PAT with Contents write access. Required when the default\n          branch is protected by a ruleset — github.token cannot push through\n          rulesets, but a PAT with admin bypass can. Falls back to github.token.\n        required: false\n\njobs:\n  release:\n    name: Semantic release\n    permissions:\n      contents: write\n      id-token: write\n      issues: write\n      pull-requests: write\n    runs-on: ubuntu-latest\n    timeout-minutes: 30\n    # Do not cancel in-progress releases — a partial release is worse than a slow one.\n    concurrency:\n      group: release-${{ github.ref }}\n      cancel-in-progress: false\n    steps:\n      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0\n        name: Checkout repository\n        with:\n          fetch-depth: 0\n          # Use SYNC_TOKEN when available — git push (tags, release commits)\n          # uses the checkout credential, not GITHUB_TOKEN env var. The\n          # built-in github.token cannot push through branch protection rulesets.\n          token: ${{ secrets.SYNC_TOKEN || github.token }}\n\n      - uses: theholocron/.github/.github/actions/setup@main\n        name: Setup\n\n      - name: Configure git identity\n        run: |\n          GIT_NAME=$(gh api user --jq .name 2>/dev/null || echo \"github-actions[bot]\")\n          GIT_EMAIL=$(gh api user --jq '\"\\(.id)+\\(.login)@users.noreply.github.com\"' 2>/dev/null || echo \"41898282+github-actions[bot]@users.noreply.github.com\")\n          git config --global user.name \"$GIT_NAME\"\n          git config --global user.email \"$GIT_EMAIL\"\n          git config --global format.signoff true\n        env:\n          GH_TOKEN: ${{ secrets.SYNC_TOKEN || github.token }}\n\n      - run: npm install -g npm@11 sigstore\n        name: Upgrade npm for OIDC support\n        # sigstore is required by libnpmpublish/provenance.js at module parse\n        # time — before any config takes effect. Some npm 11.x builds stopped\n        # bundling it; installing it globally into the same prefix ensures it\n        # resolves regardless of npm version. (Discovered 2026-07-09.)\n\n      - run: pnpm build\n        name: Build\n        if: ${{ inputs.run-build == true }}\n\n      - run: npx semantic-release\n        name: Release\n        env:\n          # Prefer SYNC_TOKEN (a PAT with Contents write) when available —\n          # the built-in github.token cannot push to protected default branches\n          # because rulesets block non-PAT pushes. Falls back to github.token\n          # for repos without branch protection.\n          GITHUB_TOKEN: ${{ secrets.SYNC_TOKEN || github.token }}\n          NPM_CONFIG_PROVENANCE: true\n";
 //#endregion
 //#region src/templates/workflows/review.yml
-var review_default$1 = "name: Review\n\n# ReviewDog is the annotation layer — posts inline PR diff annotations.\n# Runs on pull_request only: inline annotations require PR context,\n# and branch protection ensures all changes go through PRs anyway.\n# super-linter (lint.yml) is the CI gate covering push + PR events.\n# Gitleaks and YAML are intentionally duplicated: super-linter gates\n# merges; ReviewDog surfaces exact line annotations in the PR diff.\n\non: # yamllint disable-line rule:truthy\n  workflow_call:\n\nconcurrency:\n  group: review-${{ github.workflow }}-${{ github.ref }}\n  cancel-in-progress: true\n\njobs:\n  reviewdog:\n    name: Review PRs\n    runs-on: ubuntu-latest\n    timeout-minutes: 20\n    permissions:\n      contents: read\n      checks: write\n      pull-requests: write\n\n    steps:\n      - name: Checkout repository\n        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0\n        with:\n          fetch-depth: 0\n\n      - name: Setup\n        if: ${{ hashFiles('pnpm-lock.yaml') != '' }}\n        uses: theholocron/.github/.github/actions/setup@main\n\n      - name: Install ReviewDog\n        uses: reviewdog/action-setup@d8a7baabd7f3e8544ee4dbde3ee41d0011c3a93f # v1\n        with:\n          reviewdog_version: latest\n\n      # Detect which tools are relevant for this repo, excluding node_modules.\n      # hashFiles('**/*') recurses into node_modules/.pnpm and produces false\n      # positives for repos that don't own those file types.\n      # -print -quit stops find after the first match without a pipe, avoiding\n      # the SIGPIPE/pipefail exit-141 that find|head-1 triggers under\n      # GitHub Actions' default bash --noprofile --norc -e -o pipefail mode.\n      - name: Detect project features\n        id: detect\n        shell: bash\n        run: |\n          has() { find . -not -path '*/node_modules/*' -name \"$1\" -print -quit 2>/dev/null | grep -q .; }\n          has_ext() { find . -not -path '*/node_modules/*' -name \"$1\" -print -quit 2>/dev/null | grep -q .; }\n          { { has 'eslint.config.js' || has 'eslint.config.mjs' || has 'eslint.config.cjs' || \\\n              has 'eslint.config.ts' || has '.eslintrc' || has '.eslintrc.js' || \\\n              has '.eslintrc.cjs' || has '.eslintrc.json' || has '.eslintrc.yaml' || \\\n              has '.eslintrc.yml'; } && grep -qF '\"eslint\":' package.json 2>/dev/null; } && echo \"eslint=true\" >> \"$GITHUB_OUTPUT\" || echo \"eslint=false\" >> \"$GITHUB_OUTPUT\"\n          { has 'tsconfig.json' && grep -qF '\"typescript\":' package.json 2>/dev/null; } && echo \"tsconfig=true\" >> \"$GITHUB_OUTPUT\" || echo \"tsconfig=false\" >> \"$GITHUB_OUTPUT\"\n          has_ext '*.sh' && echo \"shell=true\" >> \"$GITHUB_OUTPUT\" || echo \"shell=false\" >> \"$GITHUB_OUTPUT\"\n          has 'Dockerfile' || has_ext '*.Dockerfile' || has 'Containerfile' && \\\n            echo \"docker=true\" >> \"$GITHUB_OUTPUT\" || echo \"docker=false\" >> \"$GITHUB_OUTPUT\"\n          has_ext '.env*' && echo \"dotenv=true\" >> \"$GITHUB_OUTPUT\" || echo \"dotenv=false\" >> \"$GITHUB_OUTPUT\"\n          has_ext '*.md' && echo \"markdown=true\" >> \"$GITHUB_OUTPUT\" || echo \"markdown=false\" >> \"$GITHUB_OUTPUT\"\n\n      #\n      # Always applicable\n      #\n\n      - name: Gitleaks (secrets)\n        uses: reviewdog/action-gitleaks@2b7b5685e3e3eecddab5d30cfa04f18123031421 # v1\n        with:\n          reporter: github-pr-check\n          gitleaks_flags: --log-opts=${{ github.event.pull_request.base.sha }}..${{ github.event.pull_request.head.sha }}\n\n      - name: YamlLint\n        if: ${{ hashFiles('yamllint.config.yml') != '' }}\n        uses: reviewdog/action-yamllint@b5f7217d8c815ae374d1d55840d5e569d82f01f0 # v1\n        with:\n          reporter: github-pr-check\n          yamllint_flags: -c ${{ github.workspace }}/yamllint.config.yml ${{ github.workspace }}\n\n      - name: ActionLint (GitHub Actions)\n        if: ${{ hashFiles('.github/workflows/*.yml', '.github/workflows/*.yaml') != '' }}\n        uses: reviewdog/action-actionlint@6fb7acc99f4a1008869fa8a0f09cfca740837d9d # v1\n        with:\n          reporter: github-pr-check\n\n      #\n      # TypeScript / JavaScript\n      #\n\n      - name: ESLint\n        if: steps.detect.outputs.eslint == 'true'\n        uses: reviewdog/action-eslint@556a3fdaf8b4201d4d74d406013386aa4f7dab96 # v1.34.0\n        with:\n          reporter: github-pr-check\n          eslint_flags: .\n\n      - name: TypeScript\n        if: steps.detect.outputs.tsconfig == 'true'\n        uses: EPMatt/reviewdog-action-tsc@63d923a3c5b4497671940b8874f58a404e2351b5 # v1\n        with:\n          reporter: github-pr-check\n\n      #\n      # Shell\n      #\n\n      - name: ShellCheck\n        if: steps.detect.outputs.shell == 'true'\n        uses: reviewdog/action-shellcheck@4c07458293ac342d477251099501a718ae5ef86e # v1\n        with:\n          reporter: github-pr-check\n          fail_level: none\n\n      #\n      # Docker\n      #\n\n      - name: Hadolint\n        if: steps.detect.outputs.docker == 'true'\n        uses: reviewdog/action-hadolint@1b2cfa6ba72072ad35158d7ff3aa49bbdc03506d # v1\n        with:\n          reporter: github-pr-check\n          fail_level: none\n\n      #\n      # Environment files\n      #\n\n      - name: dotenv-linter\n        if: steps.detect.outputs.dotenv == 'true'\n        uses: dotenv-linter/action-dotenv-linter@afde61cfda2ecffe7bea35837b6f20b956c88689 # v3.0.0\n        with:\n          reporter: github-code-suggestions\n\n      #\n      # Documentation\n      #\n\n      - name: Alex (inclusive language)\n        if: steps.detect.outputs.markdown == 'true'\n        uses: reviewdog/action-alex@347481655add010a2ae302df34b57c9bcfa0d6e4 # v1\n        with:\n          reporter: github-pr-check\n";
+var review_default$1 = "name: Review\n\n# ReviewDog is the annotation layer — posts inline PR diff annotations.\n# Runs on pull_request only: inline annotations require PR context,\n# and branch protection ensures all changes go through PRs anyway.\n# super-linter (lint.yml) is the CI gate covering push + PR events.\n# Gitleaks and YAML are intentionally duplicated: super-linter gates\n# merges; ReviewDog surfaces exact line annotations in the PR diff.\n\non: # yamllint disable-line rule:truthy\n  workflow_call:\n\nconcurrency:\n  group: review-${{ github.workflow }}-${{ github.ref }}\n  cancel-in-progress: true\n\njobs:\n  reviewdog:\n    name: Review PRs\n    runs-on: ubuntu-latest\n    timeout-minutes: 20\n    permissions:\n      contents: read\n      checks: write\n      pull-requests: write\n\n    steps:\n      - name: Checkout repository\n        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0\n        with:\n          fetch-depth: 0\n\n      - name: Setup\n        if: ${{ hashFiles('pnpm-lock.yaml') != '' }}\n        uses: theholocron/.github/.github/actions/setup@main\n\n      - name: Install ReviewDog\n        uses: reviewdog/action-setup@d8a7baabd7f3e8544ee4dbde3ee41d0011c3a93f # v1\n        with:\n          reviewdog_version: latest\n\n      # Detect which tools are relevant for this repo, excluding node_modules.\n      # hashFiles('**/*') recurses into node_modules/.pnpm and produces false\n      # positives for repos that don't own those file types.\n      # -print -quit stops find after the first match without a pipe, avoiding\n      # the SIGPIPE/pipefail exit-141 that find|head-1 triggers under\n      # GitHub Actions' default bash --noprofile --norc -e -o pipefail mode.\n      - name: Detect project features\n        id: detect\n        shell: bash\n        run: |\n          has() { find . -not -path '*/node_modules/*' -name \"$1\" -print -quit 2>/dev/null | grep -q .; }\n          has_ext() { find . -not -path '*/node_modules/*' -name \"$1\" -print -quit 2>/dev/null | grep -q .; }\n          { { has 'eslint.config.js' || has 'eslint.config.mjs' || has 'eslint.config.cjs' || \\\n              has 'eslint.config.ts' || has '.eslintrc' || has '.eslintrc.js' || \\\n              has '.eslintrc.cjs' || has '.eslintrc.json' || has '.eslintrc.yaml' || \\\n              has '.eslintrc.yml'; } && grep -qF '\"eslint\":' package.json 2>/dev/null; } && echo \"eslint=true\" >> \"$GITHUB_OUTPUT\" || echo \"eslint=false\" >> \"$GITHUB_OUTPUT\"\n          { has 'tsconfig.json' && grep -qF '\"typescript\":' package.json 2>/dev/null; } && echo \"tsconfig=true\" >> \"$GITHUB_OUTPUT\" || echo \"tsconfig=false\" >> \"$GITHUB_OUTPUT\"\n          has_ext '*.sh' && echo \"shell=true\" >> \"$GITHUB_OUTPUT\" || echo \"shell=false\" >> \"$GITHUB_OUTPUT\"\n          has 'Dockerfile' || has_ext '*.Dockerfile' || has 'Containerfile' && \\\n            echo \"docker=true\" >> \"$GITHUB_OUTPUT\" || echo \"docker=false\" >> \"$GITHUB_OUTPUT\"\n          has_ext '.env*' && echo \"dotenv=true\" >> \"$GITHUB_OUTPUT\" || echo \"dotenv=false\" >> \"$GITHUB_OUTPUT\"\n          has_ext '*.md' && echo \"markdown=true\" >> \"$GITHUB_OUTPUT\" || echo \"markdown=false\" >> \"$GITHUB_OUTPUT\"\n\n      #\n      # Always applicable\n      #\n\n      - name: Gitleaks (secrets)\n        uses: reviewdog/action-gitleaks@2b7b5685e3e3eecddab5d30cfa04f18123031421 # v1\n        with:\n          reporter: github-pr-check\n          tool_name: \"Review / gitleaks\"\n          gitleaks_flags: --log-opts=${{ github.event.pull_request.base.sha }}..${{ github.event.pull_request.head.sha }}\n\n      - name: YamlLint\n        if: ${{ hashFiles('yamllint.config.yml') != '' }}\n        uses: reviewdog/action-yamllint@b5f7217d8c815ae374d1d55840d5e569d82f01f0 # v1\n        with:\n          reporter: github-pr-check\n          tool_name: \"Review / yamllint\"\n          yamllint_flags: -c ${{ github.workspace }}/yamllint.config.yml ${{ github.workspace }}\n\n      - name: ActionLint (GitHub Actions)\n        if: ${{ hashFiles('.github/workflows/*.yml', '.github/workflows/*.yaml') != '' }}\n        uses: reviewdog/action-actionlint@6fb7acc99f4a1008869fa8a0f09cfca740837d9d # v1\n        with:\n          reporter: github-pr-check\n          tool_name: \"Review / actionlint\"\n\n      #\n      # TypeScript / JavaScript\n      #\n\n      - name: ESLint\n        if: steps.detect.outputs.eslint == 'true'\n        uses: reviewdog/action-eslint@556a3fdaf8b4201d4d74d406013386aa4f7dab96 # v1.34.0\n        with:\n          reporter: github-pr-check\n          tool_name: \"Review / eslint\"\n          eslint_flags: .\n\n      - name: TypeScript\n        if: steps.detect.outputs.tsconfig == 'true'\n        uses: EPMatt/reviewdog-action-tsc@63d923a3c5b4497671940b8874f58a404e2351b5 # v1\n        with:\n          reporter: github-pr-check\n          tool_name: \"Review / tsc\"\n\n      #\n      # Shell\n      #\n\n      - name: ShellCheck\n        if: steps.detect.outputs.shell == 'true'\n        uses: reviewdog/action-shellcheck@4c07458293ac342d477251099501a718ae5ef86e # v1\n        with:\n          reporter: github-pr-check\n          tool_name: \"Review / shellcheck\"\n          fail_level: none\n\n      #\n      # Docker\n      #\n\n      - name: Hadolint\n        if: steps.detect.outputs.docker == 'true'\n        uses: reviewdog/action-hadolint@1b2cfa6ba72072ad35158d7ff3aa49bbdc03506d # v1\n        with:\n          reporter: github-pr-check\n          tool_name: \"Review / hadolint\"\n          fail_level: none\n\n      #\n      # Environment files\n      #\n\n      - name: dotenv-linter\n        if: steps.detect.outputs.dotenv == 'true'\n        uses: dotenv-linter/action-dotenv-linter@afde61cfda2ecffe7bea35837b6f20b956c88689 # v3.0.0\n        with:\n          reporter: github-code-suggestions\n\n      #\n      # Documentation\n      #\n\n      - name: Alex (inclusive language)\n        if: steps.detect.outputs.markdown == 'true'\n        uses: reviewdog/action-alex@347481655add010a2ae302df34b57c9bcfa0d6e4 # v1\n        with:\n          reporter: github-pr-check\n          tool_name: \"Review / alex\"\n";
 //#endregion
 //#region src/templates/workflows/stale.yml
 var stale_default$1 = "name: Stale\n\non: # yamllint disable-line rule:truthy\n  workflow_call:\n    inputs:\n      days-before-stale:\n        description: Days of inactivity before an issue is marked stale\n        type: number\n        required: false\n        default: 30\n      days-before-close:\n        description: Days of inactivity after stale label before closing\n        type: number\n        required: false\n        default: 5\n\njobs:\n  stale:\n    name: Mark stale issues and pull requests\n    permissions:\n      contents: write\n      issues: write\n      pull-requests: write\n    runs-on: ubuntu-latest\n    timeout-minutes: 10\n    steps:\n      - uses: actions/stale@1e223db275d687790206a7acac4d1a11bd6fe629 # v10.4.0\n        name: Run Stale\n        with:\n          close-issue-message: >\n            This issue was closed because it has been stalled for\n            ${{ inputs.days-before-close }} days with no activity.\n          days-before-close: ${{ inputs.days-before-close }}\n          days-before-stale: ${{ inputs.days-before-stale }}\n          exempt-all-pr-milestones: true\n          stale-issue-label: wontfix\n          stale-issue-message: >\n            This issue is stale because it has been open ${{ inputs.days-before-stale }}\n            days with no activity. Remove the stale label or comment, or this will be\n            closed in ${{ inputs.days-before-close }} days.\n          stale-pr-label: wontfix\n          stale-pr-message: >\n            This PR is stale because it has been open ${{ inputs.days-before-stale }}\n            days with no activity. Remove the stale label or comment, or this will be\n            closed in ${{ inputs.days-before-close }} days.\n";
@@ -1430,7 +1433,7 @@ async function runNpmPublishInitial(input = {}) {
 	const dryRun = input.dryRun ?? false;
 	const otp = input.otp;
 	const env = input.env ?? process.env;
-	const exec = input.exec ?? defaultExec$1;
+	const exec = input.exec ?? defaultExec$2;
 	const publishArgs = [
 		"-r",
 		"--filter=./packages/*",
@@ -1506,7 +1509,7 @@ function printNextSteps$1(print, env) {
 		print("    https://www.npmjs.com/settings/~/tokens");
 	}
 }
-const defaultExec$1 = async (cmd, args, opts) => {
+const defaultExec$2 = async (cmd, args, opts) => {
 	const result = spawnSync(cmd, args, {
 		cwd: opts.cwd,
 		encoding: "utf8",
@@ -2485,7 +2488,7 @@ function runPluginCreate(input) {
 		filesWritten.push(resolvedPath);
 	}
 	if (!input.dryRun && !input.noVerify) {
-		const execFn = input.exec ?? defaultExec;
+		const execFn = input.exec ?? defaultExec$1;
 		const pkg = `@theholocron/holocron-plugin-${inputs.slug}`;
 		print("");
 		print("  Verifying scaffold…");
@@ -2572,7 +2575,7 @@ function defaultWrite(filepath, content) {
 	mkdirSync(path.dirname(filepath), { recursive: true });
 	writeFileSync(filepath, content, "utf8");
 }
-function defaultExec(cmd, args, opts) {
+function defaultExec$1(cmd, args, opts) {
 	execFileSync(cmd, args, {
 		cwd: opts.cwd,
 		stdio: opts.stdio
@@ -3608,6 +3611,23 @@ function formatStep(step) {
 }
 //#endregion
 //#region src/commands/skills.ts
+/**
+* `holocron skills` — install, remove, and update agent skills from @theholocron/skills.
+*
+* Unlike `holocron setup`, this command is purely local (no GitHub token
+* required). It reads `agent` and `skills` from the config and installs
+* the listed skills into `.agents/skills/<name>/` with a symlink at the
+* agent-specific path (e.g. `.claude/skills/<name>` for Claude Code).
+*
+* `holocron skills remove [name]` and `holocron skills update [name]` delegate
+* to the corresponding `npx skills` subcommands from the upstream skills CLI.
+*/
+const defaultExec = (cmd, args, opts) => {
+	return { exitCode: spawnSync(cmd, args, {
+		cwd: opts.cwd,
+		stdio: "inherit"
+	}).status ?? -1 };
+};
 async function runSkillsInstall(input) {
 	const print = input.print ?? ((line) => console.log(line));
 	const config = input.loaded.resolved;
@@ -3631,6 +3651,36 @@ async function runSkillsInstall(input) {
 		print(`  ✗ ${err instanceof Error ? err.message : String(err)}`);
 	}
 }
+function runSkillsRemove(input) {
+	const { dryRun, repoRoot } = input.context;
+	const exec = input.exec ?? defaultExec;
+	const args = [
+		"skills",
+		"remove",
+		...input.names ?? []
+	];
+	if (dryRun) {
+		console.log(`Would run: npx ${args.join(" ")}`);
+		return { status: "dry-run" };
+	}
+	const { exitCode } = exec("npx", args, { cwd: repoRoot });
+	return { status: exitCode === 0 ? "ok" : "fail" };
+}
+function runSkillsUpdate(input) {
+	const { dryRun, repoRoot } = input.context;
+	const exec = input.exec ?? defaultExec;
+	const args = [
+		"skills",
+		"update",
+		...input.name ? [input.name] : []
+	];
+	if (dryRun) {
+		console.log(`Would run: npx ${args.join(" ")}`);
+		return { status: "dry-run" };
+	}
+	const { exitCode } = exec("npx", args, { cwd: repoRoot });
+	return { status: exitCode === 0 ? "ok" : "fail" };
+}
 //#endregion
 //#region src/commands/sync.ts
 const SYNC_STEPS = [
@@ -4025,15 +4075,68 @@ async function fileExists(path) {
 	}
 }
 //#endregion
+//#region src/token-args.ts
+var TokenParseError = class extends Error {
+	name = "TokenParseError";
+};
+/**
+* Converts raw --token CLI values into a typed result.
+*
+* Bare form:   --token ghp_xxx            → { cliToken: "ghp_xxx" }
+* Keyed form:  --token github=ghp_xxx     → { cliTokens: { github: "ghp_xxx" } }
+* Mixed:       --token github=ghp_xxx --token v_yyy
+*                                         → { cliToken: "v_yyy", cliTokens: { github: "ghp_xxx" } }
+*
+* Values may contain "=" (e.g. base64 strings) — only the first "=" is treated as a separator.
+*/
+function parseTokenArgs(tokens) {
+	if (tokens.length === 0) return {};
+	const cliTokens = {};
+	const bare = [];
+	for (const raw of tokens) {
+		const eqIdx = raw.indexOf("=");
+		if (eqIdx === -1) {
+			bare.push(raw);
+			continue;
+		}
+		const vendor = raw.slice(0, eqIdx);
+		const value = raw.slice(eqIdx + 1);
+		if (vendor.trim() === "") throw new TokenParseError(`invalid --token value "${raw}": vendor name must not be empty`);
+		if (/\s/.test(vendor)) throw new TokenParseError(`invalid --token value "${raw}": vendor name must not contain whitespace`);
+		if (value === "") throw new TokenParseError(`invalid --token value "${raw}": token value must not be empty`);
+		cliTokens[vendor] = value;
+	}
+	if (bare.length > 1) throw new TokenParseError(`only one bare --token value is allowed; got ${bare.length.toString()} — use vendor=value form for multiple tokens`);
+	const result = {};
+	if (bare.length === 1) result.cliToken = bare[0];
+	if (Object.keys(cliTokens).length > 0) result.cliTokens = cliTokens;
+	return result;
+}
+//#endregion
 //#region src/cli.ts
 const { version: CLI_VERSION } = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
+/** Parses --token values and returns the context spread, or null on parse error (exits with code 1). */
+function tokenContext(rawTokens) {
+	if (!rawTokens?.length) return {};
+	try {
+		return parseTokenArgs(rawTokens);
+	} catch (err) {
+		if (err instanceof TokenParseError) {
+			console.error(`--token: ${err.message}`);
+			process.exitCode = 1;
+			return null;
+		}
+		throw err;
+	}
+}
 await yargs(hideBin(process.argv)).scriptName("holocron").usage("$0 <command> [options]").option("dry-run", {
 	type: "boolean",
 	default: false,
 	describe: "Print what would be mutated without calling capability mutators. Commands branch on this; read-only commands ignore it."
 }).option("token", {
 	type: "string",
-	describe: "Vendor token passed to plugins as `cliToken`, taking precedence over env vars. Unambiguous for single-plugin commands; for multi-plugin flows pass per-vendor env vars instead."
+	array: true,
+	describe: "Vendor token override for plugins. Bare form: --token <value> (fallback for all plugins, single-plugin commands). Keyed form: --token vendor=value (targets a specific provider; repeat for each). Example: --token github=ghp_xxx --token vercel=v_yyy"
 }).option("cwd", {
 	type: "string",
 	default: process.cwd(),
@@ -4044,41 +4147,64 @@ await yargs(hideBin(process.argv)).scriptName("holocron").usage("$0 <command> [o
 	type: "string",
 	describe: "Repo coords (\"owner/name\"). Defaults to plugin-specific resolution."
 }), async (argv) => {
+	const tokens = tokenContext(argv.token);
+	if (!tokens) return;
 	if ((await runDoctor({
 		loaded: await loadConfig(argv.cwd),
 		context: {
 			repoRoot: argv.cwd,
 			dryRun: argv.dryRun,
 			...argv.repo ? { repo: argv.repo } : {},
-			...argv.token ? { cliToken: argv.token } : {}
+			...tokens
 		}
 	})).summary.fail > 0) process.exitCode = 1;
 }).command("setup", "Apply infra setup actions across every configured capability", (y) => y.option("repo", {
 	type: "string",
 	describe: "Repo coords (\"owner/name\"). Defaults to plugin-specific resolution."
 }), async (argv) => {
+	const tokens = tokenContext(argv.token);
+	if (!tokens) return;
 	if ((await runSetup({
 		loaded: await loadConfig(argv.cwd),
 		context: {
 			repoRoot: argv.cwd,
 			dryRun: argv.dryRun,
 			...argv.repo ? { repo: argv.repo } : {},
-			...argv.token ? { cliToken: argv.token } : {}
+			...tokens
 		}
 	})).summary.fail > 0) process.exitCode = 1;
-}).command("skills <action>", "Manage agent skills from the @theholocron/skills registry", (y) => y.positional("action", {
-	type: "string",
-	choices: ["install"],
-	describe: "install — copy skills from @theholocron/skills into .agents/ with agent symlinks"
-}), async (argv) => {
-	if (argv.action === "install") await runSkillsInstall({
+}).command("skills", "Manage agent skills from the @theholocron/skills registry", (y) => y.command("install", "Copy skills from @theholocron/skills into .agents/ with agent symlinks", () => {}, async (argv) => {
+	await runSkillsInstall({
 		loaded: await loadConfig(argv.cwd),
 		context: {
 			repoRoot: argv.cwd,
 			dryRun: argv.dryRun
 		}
 	});
-}).command("secret set <name> [value]", "Set a single secret via the configured `secrets` capability", (y) => y.positional("name", {
+}).command("remove [names..]", "Remove installed skills via npx skills remove", (yy) => yy.positional("names", {
+	type: "string",
+	array: true,
+	describe: "Skill name(s) to remove (omit to remove all installed skills)"
+}), (argv) => {
+	if (runSkillsRemove({
+		context: {
+			repoRoot: argv.cwd,
+			dryRun: argv.dryRun
+		},
+		...argv.names?.length ? { names: argv.names } : {}
+	}).status === "fail") process.exitCode = 1;
+}).command("update [name]", "Update installed skills to their latest upstream versions via npx skills update", (yy) => yy.positional("name", {
+	type: "string",
+	describe: "Skill name to update (omit to update all installed skills)"
+}), (argv) => {
+	if (runSkillsUpdate({
+		context: {
+			repoRoot: argv.cwd,
+			dryRun: argv.dryRun
+		},
+		...argv.name ? { name: argv.name } : {}
+	}).status === "fail") process.exitCode = 1;
+}).demandCommand(1, "Run `holocron skills --help` to see available skills subcommands."), () => {}).command("secret set <name> [value]", "Set a single secret via the configured `secrets` capability", (y) => y.positional("name", {
 	type: "string",
 	demandOption: true,
 	describe: "Secret name (e.g., NPM_TOKEN)"
@@ -4097,6 +4223,8 @@ await yargs(hideBin(process.argv)).scriptName("holocron").usage("$0 <command> [o
 	default: "repo",
 	describe: "Scope: \"repo\" (default), \"env=<name>\", or \"org=<name>\""
 }), async (argv) => {
+	const tokens = tokenContext(argv.token);
+	if (!tokens) return;
 	const scopeArg = argv.scope;
 	const scope = parseScope(scopeArg);
 	if ((await runSecretSet({
@@ -4104,7 +4232,7 @@ await yargs(hideBin(process.argv)).scriptName("holocron").usage("$0 <command> [o
 		context: {
 			repoRoot: argv.cwd,
 			dryRun: argv.dryRun,
-			...argv.token ? { cliToken: argv.token } : {}
+			...tokens
 		},
 		name: argv.name,
 		...argv.value ? { value: argv.value } : {},
@@ -4124,12 +4252,14 @@ await yargs(hideBin(process.argv)).scriptName("holocron").usage("$0 <command> [o
 	default: ["production", "preview"],
 	describe: "Deployment targets to sync to. Defaults to production + preview."
 }), async (argv) => {
+	const tokens = tokenContext(argv.token);
+	if (!tokens) return;
 	if ((await runSecretsSync({
 		loaded: await loadConfig(argv.cwd),
 		context: {
 			repoRoot: argv.cwd,
 			dryRun: argv.dryRun,
-			...argv.token ? { cliToken: argv.token } : {}
+			...tokens
 		},
 		environmentId: argv.environmentId,
 		...argv.projectId ? { projectId: argv.projectId } : {},
@@ -4148,12 +4278,14 @@ await yargs(hideBin(process.argv)).scriptName("holocron").usage("$0 <command> [o
 	choices: ["production", "staging"],
 	describe: "Named environment to deploy into. Omit for a branch preview."
 }), async (argv) => {
+	const tokens = tokenContext(argv.token);
+	if (!tokens) return;
 	if ((await runDeploy({
 		loaded: await loadConfig(argv.cwd),
 		context: {
 			repoRoot: argv.cwd,
 			dryRun: argv.dryRun,
-			...argv.token ? { cliToken: argv.token } : {}
+			...tokens
 		},
 		projectId: argv.projectId,
 		branch: argv.branch,
@@ -4191,13 +4323,15 @@ await yargs(hideBin(process.argv)).scriptName("holocron").usage("$0 <command> [o
 	type: "string",
 	describe: "Repo coords (\"owner/name\"). Defaults to plugin-specific resolution."
 }), async (argv) => {
+	const tokens = tokenContext(argv.token);
+	if (!tokens) return;
 	if ((await runSync({
 		loaded: await loadConfig(argv.cwd),
 		context: {
 			repoRoot: argv.cwd,
 			dryRun: argv.dryRun,
 			...argv.repo ? { repo: argv.repo } : {},
-			...argv.token ? { cliToken: argv.token } : {}
+			...tokens
 		},
 		...argv.steps && argv.steps.length > 0 ? { steps: argv.steps } : {}
 	})).summary.fail > 0) process.exitCode = 1;
@@ -4220,7 +4354,9 @@ await yargs(hideBin(process.argv)).scriptName("holocron").usage("$0 <command> [o
 	describe: "Write generated files to this local directory instead of pushing (for validation)"
 }), async (argv) => {
 	const outputDir = argv["output-dir"];
-	const token = outputDir ? "no-token-needed" : argv.token ?? process.env.GITHUB_TOKEN ?? process.env.HOLOCRON_GITHUB_TOKEN;
+	const parsed = tokenContext(argv.token);
+	if (!parsed) return;
+	const token = outputDir ? "no-token-needed" : parsed.cliTokens?.["github"] ?? parsed.cliToken ?? process.env.GITHUB_TOKEN ?? process.env.HOLOCRON_GITHUB_TOKEN;
 	if (!token) {
 		console.error("sync-github: GitHub token required — pass --token or set GITHUB_TOKEN");
 		process.exitCode = 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/cli",
-  "version": "2.0.0-alpha.72",
+  "version": "2.0.0-alpha.74",
   "description": "The Holocron CLI — a pluggable, capability-based orchestrator for spinning up and operating software projects.",
   "homepage": "https://github.com/theholocron/holocron/tree/main/packages/cli#readme",
   "bugs": "https://github.com/theholocron/holocron/issues",