Skip to content

Context7 Platform -- Up-to-date docs for AI agents

feat: add skills registry CLI for managing AI coding agent skills (#1505)

Fahreddin Özcan1fbd3d906ca4
diff --git a/.gitignore b/.gitignore
index 8ed73794..616cca16 100644
--- a/.gitignore
+++ b/.gitignore
@@ -172,6 +172,8 @@ dist
.idea
.cursor
+.opencode
+.claude
# Finder (MacOS) folder config
.DS_Store
diff --git a/packages/cli/.gitignore b/packages/cli/.gitignore
new file mode 100644
index 00000000..deed335b
--- /dev/null
+++ b/packages/cli/.gitignore
@@ -0,0 +1,3 @@
+node_modules/
+dist/
+.env
diff --git a/packages/cli/README.md b/packages/cli/README.md
new file mode 100644
index 00000000..4b0a1294
--- /dev/null
+++ b/packages/cli/README.md
@@ -0,0 +1,117 @@
+# ctx7
+
+CLI for the [Context7 Skills Registry](https://context7.com) - install and manage AI coding skills across different AI coding assistants.
+
+Skills are reusable prompt instructions that enhance your AI coding assistant with specialized capabilities like working with specific frameworks, libraries, or coding patterns.
+
+## Installation
+
+```bash
+# Run directly with npx (no install needed)
+npx ctx7
+
+# Or install globally
+npm install -g ctx7
+```
+
+## Quick Start
+
+```bash
+# Search for skills
+ctx7 skills search pdf
+
+# Install a skill
+ctx7 skills install /anthropics/skills pdf
+
+# List installed skills
+ctx7 skills list --claude
+```
+
+## Usage
+
+### Install skills
+
+Install skills from a project repository to your AI coding assistant's skills directory.
+
+```bash
+# Install all skills from a project (interactive selection)
+ctx7 skills install /anthropics/skills
+
+# Install a specific skill
+ctx7 skills install /anthropics/skills pdf
+
+# Install multiple skills at once
+ctx7 skills install /anthropics/skills pdf commit
+
+# Install to a specific client
+ctx7 skills install /anthropics/skills pdf --cursor
+ctx7 skills install /anthropics/skills pdf --claude
+
+# Install globally (home directory instead of current project)
+ctx7 skills install /anthropics/skills pdf --global
+```
+
+### Search for skills
+
+Find skills across all indexed projects in the registry.
+
+```bash
+ctx7 skills search pdf
+ctx7 skills search typescript
+ctx7 skills search react testing
+```
+
+### List installed skills
+
+View skills installed in your project or globally.
+
+```bash
+ctx7 skills list
+ctx7 skills list --claude
+ctx7 skills list --cursor
+ctx7 skills list --global
+```
+
+### Show skill information
+
+Get details about available skills in a project.
+
+```bash
+ctx7 skills info /anthropics/skills
+```
+
+### Remove a skill
+
+Uninstall a skill from your project.
+
+```bash
+ctx7 skills remove pdf
+ctx7 skills remove pdf --claude
+ctx7 skills remove pdf --global
+```
+
+## Supported Clients
+
+The CLI automatically detects which AI coding assistants you have installed and offers to install skills for them:
+
+| Client | Skills Directory |
+|--------|-----------------|
+| Claude Code | `.claude/skills/` |
+| Cursor | `.cursor/skills/` |
+| Codex | `.codex/skills/` |
+| OpenCode | `.opencode/skills/` |
+| Amp | `.agents/skills/` |
+| Antigravity | `.agent/skills/` |
+
+## Shortcuts
+
+For faster usage, the CLI provides short aliases:
+
+```bash
+ctx7 si /anthropics/skills pdf # skills install
+ctx7 ss pdf # skills search
+```
+
+## Learn More
+
+Visit [context7.com](https://context7.com) to browse the skills registry and discover available skills.
diff --git a/packages/cli/eslint.config.js b/packages/cli/eslint.config.js
new file mode 100644
index 00000000..fe7c0fb7
--- /dev/null
+++ b/packages/cli/eslint.config.js
@@ -0,0 +1,47 @@
+import { defineConfig } from "eslint/config";
+import tseslint from "typescript-eslint";
+import eslintPluginPrettier from "eslint-plugin-prettier";
+
+export default defineConfig(
+ {
+ // Base ESLint configuration
+ ignores: ["node_modules/**", "build/**", "dist/**", ".git/**", ".github/**", "tsup.config.ts"],
+ },
+ {
+ files: ["**/*.ts", "**/*.tsx"],
+ languageOptions: {
+ ecmaVersion: 2020,
+ sourceType: "module",
+ parser: tseslint.parser,
+ parserOptions: {
+ project: "./tsconfig.json",
+ tsconfigRootDir: import.meta.dirname,
+ },
+ globals: {
+ // Add Node.js globals
+ process: "readonly",
+ require: "readonly",
+ module: "writable",
+ console: "readonly",
+ },
+ },
+ // Settings for all files
+ linterOptions: {
+ reportUnusedDisableDirectives: true,
+ },
+ plugins: {
+ "@typescript-eslint": tseslint.plugin,
+ prettier: eslintPluginPrettier,
+ },
+ rules: {
+ // TypeScript recommended rules
+ ...tseslint.configs.recommended.rules,
+ // TypeScript rules
+ "@typescript-eslint/explicit-module-boundary-types": "off",
+ "@typescript-eslint/no-unused-vars": ["error", { argsIgnorePattern: "^_" }],
+ "@typescript-eslint/no-explicit-any": "warn",
+ // Prettier integration
+ "prettier/prettier": "error",
+ },
+ }
+);
diff --git a/packages/cli/package.json b/packages/cli/package.json
new file mode 100644
index 00000000..cbd2ec80
--- /dev/null
+++ b/packages/cli/package.json
@@ -0,0 +1,63 @@
+{
+ "name": "ctx7",
+ "version": "0.1.0-canary.3",
+ "description": "Context7 CLI - Manage AI coding skills and documentation context",
+ "type": "module",
+ "bin": {
+ "ctx7": "./dist/index.js"
+ },
+ "files": [
+ "dist"
+ ],
+ "scripts": {
+ "build": "tsup",
+ "dev": "tsup --watch",
+ "typecheck": "tsc --noEmit",
+ "lint": "eslint src --fix",
+ "lint:check": "eslint src",
+ "format": "prettier --write src",
+ "format:check": "prettier --check src",
+ "clean": "rm -rf dist node_modules"
+ },
+ "dependencies": {
+ "@inquirer/prompts": "^8.2.0",
+ "commander": "^13.1.0",
+ "figlet": "^1.9.4",
+ "ora": "^9.0.0",
+ "picocolors": "^1.1.1"
+ },
+ "devDependencies": {
+ "@types/figlet": "^1.7.0",
+ "@types/node": "^22.19.1",
+ "@typescript-eslint/eslint-plugin": "^8.28.0",
+ "@typescript-eslint/parser": "^8.28.0",
+ "eslint": "^9.34.0",
+ "eslint-plugin-prettier": "^5.2.5",
+ "prettier": "^3.6.2",
+ "tsup": "^8.5.0",
+ "typescript": "^5.8.2",
+ "typescript-eslint": "^8.28.0"
+ },
+ "keywords": [
+ "context7",
+ "cli",
+ "ai",
+ "skills",
+ "documentation",
+ "mcp"
+ ],
+ "author": "Upstash",
+ "license": "MIT",
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/upstash/context7.git",
+ "directory": "packages/cli"
+ },
+ "bugs": {
+ "url": "https://github.com/upstash/context7/issues"
+ },
+ "homepage": "https://context7.com",
+ "engines": {
+ "node": ">=18"
+ }
+}
diff --git a/packages/cli/src/commands/skill.ts b/packages/cli/src/commands/skill.ts
new file mode 100644
index 00000000..20a7bc46
--- /dev/null
+++ b/packages/cli/src/commands/skill.ts
@@ -0,0 +1,566 @@
+import { Command } from "commander";
+import pc from "picocolors";
+import { checkbox } from "@inquirer/prompts";
+import ora from "ora";
+import { readdir, rm } from "fs/promises";
+import { join } from "path";
+
+import { parseSkillInput } from "../utils/parse-input.js";
+import { listProjectSkills, searchSkills, downloadSkill } from "../utils/api.js";
+import { log } from "../utils/logger.js";
+import {
+ promptForInstallTargets,
+ promptForSingleTarget,
+ getTargetDirs,
+ getTargetDirFromSelection,
+} from "../utils/ide.js";
+import { installSkillFiles, symlinkSkill } from "../utils/installer.js";
+import type {
+ Skill,
+ SkillSearchResult,
+ AddOptions,
+ ListOptions,
+ RemoveOptions,
+ InstallTargets,
+} from "../types.js";
+import { IDE_NAMES } from "../types.js";
+
+function logInstallSummary(
+ targets: InstallTargets,
+ targetDirs: string[],
+ skillNames: string[]
+): void {
+ log.blank();
+ let dirIndex = 0;
+ for (const ide of targets.ides) {
+ for (let i = 0; i < targets.scopes.length; i++) {
+ const dir = targetDirs[dirIndex++];
+ log.dim(`${IDE_NAMES[ide]}: ${dir}`);
+ for (const name of skillNames) {
+ log.itemAdd(name);
+ }
+ }
+ }
+ log.blank();
+}
+
+export function registerSkillCommands(program: Command): void {
+ const skill = program.command("skills").alias("skill").description("Manage AI coding skills");
+
+ skill
+ .command("install")
+ .alias("i")
+ .alias("add")
+ .argument("<repository>", "GitHub repository (/owner/repo)")
+ .argument("[skills...]", "Specific skill names to install")
+ .option("--all", "Install all skills without prompting")
+ .option("--global", "Install globally instead of current directory")
+ .option("--claude", "Claude Code (.claude/skills/)")
+ .option("--cursor", "Cursor (.cursor/skills/)")
+ .option("--codex", "Codex (.codex/skills/)")
+ .option("--opencode", "OpenCode (.opencode/skills/)")
+ .option("--amp", "Amp (.agents/skills/)")
+ .option("--antigravity", "Antigravity (.agent/skills/)")
+ .description("Install skills from a repository")
+ .action(async (project: string, skillNames: string[], options: AddOptions) => {
+ await installCommand(project, skillNames, options);
+ });
+
+ skill
+ .command("search")
+ .alias("s")
+ .argument("<keywords...>", "Search keywords")
+ .description("Search for skills across all indexed repositories")
+ .action(async (keywords: string[]) => {
+ await searchCommand(keywords.join(" "));
+ });
+
+ skill
+ .command("list")
+ .alias("ls")
+ .option("--global", "List global skills")
+ .option("--claude", "Claude Code (.claude/skills/)")
+ .option("--cursor", "Cursor (.cursor/skills/)")
+ .option("--codex", "Codex (.codex/skills/)")
+ .option("--opencode", "OpenCode (.opencode/skills/)")
+ .option("--amp", "Amp (.agents/skills/)")
+ .option("--antigravity", "Antigravity (.agent/skills/)")
+ .description("List installed skills")
+ .action(async (options: ListOptions) => {
+ await listCommand(options);
+ });
+
+ skill
+ .command("remove")
+ .alias("rm")
+ .alias("delete")
+ .argument("<name>", "Skill name to remove")
+ .option("--global", "Remove from global skills")
+ .option("--claude", "Claude Code (.claude/skills/)")
+ .option("--cursor", "Cursor (.cursor/skills/)")
+ .option("--codex", "Codex (.codex/skills/)")
+ .option("--opencode", "OpenCode (.opencode/skills/)")
+ .option("--amp", "Amp (.agents/skills/)")
+ .option("--antigravity", "Antigravity (.agent/skills/)")
+ .description("Remove an installed skill")
+ .action(async (name: string, options: RemoveOptions) => {
+ await removeCommand(name, options);
+ });
+
+ skill
+ .command("info")
+ .argument("<repository>", "GitHub repository (/owner/repo)")
+ .description("Show skills in a repository")
+ .action(async (project: string) => {
+ await infoCommand(project);
+ });
+}
+
+export function registerSkillAliases(program: Command): void {
+ program
+ .command("si", { hidden: true })
+ .argument("<repository>", "GitHub repository (/owner/repo)")
+ .argument("[skills...]", "Specific skill names to install")
+ .option("--all", "Install all skills without prompting")
+ .option("--global", "Install globally instead of current directory")
+ .option("--claude", "Claude Code (.claude/skills/)")
+ .option("--cursor", "Cursor (.cursor/skills/)")
+ .option("--codex", "Codex (.codex/skills/)")
+ .option("--opencode", "OpenCode (.opencode/skills/)")
+ .option("--amp", "Amp (.agents/skills/)")
+ .option("--antigravity", "Antigravity (.agent/skills/)")
+ .description("Install skills (alias for: skills install)")
+ .action(async (project: string, skillNames: string[], options: AddOptions) => {
+ await installCommand(project, skillNames, options);
+ });
+
+ program
+ .command("ss", { hidden: true })
+ .argument("<keywords...>", "Search keywords")
+ .description("Search for skills (alias for: skills search)")
+ .action(async (keywords: string[]) => {
+ await searchCommand(keywords.join(" "));
+ });
+}
+
+async function installCommand(
+ input: string,
+ skillNames: string[],
+ options: AddOptions
+): Promise<void> {
+ const parsed = parseSkillInput(input);
+ if (!parsed) {
+ log.error(`Invalid input format: ${input}`);
+ log.info(`Expected: /owner/repo or full GitHub URL`);
+ log.info(`Example: ctx7 skills install /anthropics/skills pdf`);
+ log.blank();
+ return;
+ }
+ const repo = `/${parsed.owner}/${parsed.repo}`;
+
+ log.blank();
+ const spinner = ora(`Fetching skills from ${repo}...`).start();
+
+ const data = await listProjectSkills(repo);
+
+ if (data.error) {
+ spinner.fail(pc.red(`Error: ${data.message || data.error}`));
+ return;
+ }
+
+ if (!data.skills || data.skills.length === 0) {
+ spinner.warn(pc.yellow(`No skills found in ${repo}`));
+ return;
+ }
+
+ const skillsWithRepo = data.skills.map((s) => ({ ...s, project: repo }));
+
+ let selectedSkills: (Skill & { project: string })[];
+
+ if (skillNames.length > 0) {
+ selectedSkills = skillsWithRepo.filter((s) =>
+ skillNames.some((name) => s.name.toLowerCase() === name.toLowerCase())
+ );
+
+ const foundNames = selectedSkills.map((s) => s.name.toLowerCase());
+ const notFound = skillNames.filter((name) => !foundNames.includes(name.toLowerCase()));
+
+ if (selectedSkills.length === 0) {
+ spinner.fail(pc.red(`Skills not found: ${skillNames.join(", ")}`));
+ return;
+ }
+
+ spinner.succeed(`Found ${selectedSkills.length} of ${skillNames.length} requested skill(s)`);
+
+ if (notFound.length > 0) {
+ log.warn(`Not found: ${notFound.join(", ")}`);
+ }
+ } else if (options.all || data.skills.length === 1) {
+ spinner.succeed(`Found ${data.skills.length} skill(s)`);
+ selectedSkills = skillsWithRepo;
+ } else {
+ spinner.succeed(`Found ${data.skills.length} skill(s)`);
+ const maxNameLen = Math.min(25, Math.max(...data.skills.map((s) => s.name.length)));
+ const choices = skillsWithRepo.map((s) => {
+ const paddedName = s.name.padEnd(maxNameLen);
+ const desc = s.description?.trim()
+ ? s.description.slice(0, 60) + (s.description.length > 60 ? "..." : "")
+ : "";
+
+ return {
+ name: desc ? `${paddedName} ${pc.dim(desc)}` : s.name,
+ value: s,
+ };
+ });
+
+ log.blank();
+
+ try {
+ selectedSkills = await checkbox({
+ message: "Select skills:",
+ choices,
+ pageSize: 15,
+ theme: {
+ style: {
+ renderSelectedChoices: (selected: Array<{ name?: string; value: unknown }>) =>
+ selected.map((c) => (c.value as { name: string }).name).join(", "),
+ },
+ },
+ });
+ } catch {
+ log.warn("Installation cancelled");
+ return;
+ }
+ }
+
+ if (selectedSkills.length === 0) {
+ log.warn("No skills selected");
+ return;
+ }
+
+ const targets = await promptForInstallTargets(options);
+ if (!targets) {
+ log.warn("Installation cancelled");
+ return;
+ }
+
+ const targetDirs = getTargetDirs(targets);
+
+ const installSpinner = ora("Installing skills...").start();
+
+ let installedCount = 0;
+ let permissionError = false;
+ const failedDirs: Set<string> = new Set();
+
+ for (const skill of selectedSkills) {
+ try {
+ installSpinner.text = `Downloading ${skill.name}...`;
+ const downloadData = await downloadSkill(skill.project, skill.name);
+
+ if (downloadData.error) {
+ log.warn(`Failed to download ${skill.name}: ${downloadData.error}`);
+ continue;
+ }
+
+ installSpinner.text = `Installing ${skill.name}...`;
+
+ const [primaryDir, ...symlinkDirs] = targetDirs;
+
+ try {
+ await installSkillFiles(skill.name, downloadData.files, primaryDir);
+ } catch (dirErr) {
+ const error = dirErr as NodeJS.ErrnoException;
+ if (error.code === "EACCES" || error.code === "EPERM") {
+ permissionError = true;
+ failedDirs.add(primaryDir);
+ }
+ throw dirErr;
+ }
+
+ const primarySkillDir = join(primaryDir, skill.name);
+ for (const targetDir of symlinkDirs) {
+ try {
+ await symlinkSkill(skill.name, primarySkillDir, targetDir);
+ } catch (dirErr) {
+ const error = dirErr as NodeJS.ErrnoException;
+ if (error.code === "EACCES" || error.code === "EPERM") {
+ permissionError = true;
+ failedDirs.add(targetDir);
+ }
+ throw dirErr;
+ }
+ }
+
+ installedCount++;
+ } catch (err) {
+ const error = err as NodeJS.ErrnoException;
+ if (error.code === "EACCES" || error.code === "EPERM") {
+ continue;
+ }
+ const errMsg = err instanceof Error ? err.message : String(err);
+ log.warn(`Failed to install ${skill.name}: ${errMsg}`);
+ }
+ }
+
+ if (permissionError) {
+ installSpinner.fail("Permission denied");
+ log.blank();
+ log.warn("Fix permissions with:");
+ for (const dir of failedDirs) {
+ const parentDir = join(dir, "..");
+ log.dim(` sudo chown -R $(whoami) "${parentDir}"`);
+ }
+ log.blank();
+ return;
+ }
+
+ installSpinner.succeed(`Installed ${installedCount} skill(s)`);
+
+ const installedNames = selectedSkills.map((s) => s.name);
+ logInstallSummary(targets, targetDirs, installedNames);
+}
+
+async function searchCommand(query: string): Promise<void> {
+ log.blank();
+ const spinner = ora(`Searching for "${query}"...`).start();
+
+ let data;
+ try {
+ data = await searchSkills(query);
+ } catch (err) {
+ spinner.fail(pc.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+ return;
+ }
+
+ if (data.error) {
+ spinner.fail(pc.red(`Error: ${data.message || data.error}`));
+ return;
+ }
+
+ if (!data.results || data.results.length === 0) {
+ spinner.warn(pc.yellow(`No skills found matching "${query}"`));
+ return;
+ }
+
+ spinner.succeed(`Found ${data.results.length} skill(s)`);
+
+ const maxNameLen = Math.min(25, Math.max(...data.results.map((s) => s.name.length)));
+ const choices = data.results.map((s) => {
+ const paddedName = s.name.padEnd(maxNameLen);
+ const repoName = pc.dim(`(${s.project})`);
+ const desc = s.description?.trim()
+ ? s.description.slice(0, 50) + (s.description.length > 50 ? "..." : "")
+ : "";
+
+ return {
+ name: desc ? `${paddedName} ${repoName} ${pc.dim(desc)}` : `${paddedName} ${repoName}`,
+ value: s,
+ };
+ });
+
+ log.blank();
+
+ let selectedSkills: SkillSearchResult[];
+ try {
+ selectedSkills = await checkbox({
+ message: "Select skills to install:",
+ choices,
+ pageSize: 15,
+ theme: {
+ style: {
+ renderSelectedChoices: (selected: Array<{ name?: string; value: unknown }>) =>
+ selected.map((c) => (c.value as SkillSearchResult).name).join(", "),
+ },
+ },
+ });
+ } catch {
+ log.warn("Installation cancelled");
+ return;
+ }
+
+ const uniqueSkills = selectedSkills;
+
+ if (uniqueSkills.length === 0) {
+ log.warn("No skills selected");
+ return;
+ }
+
+ const targets = await promptForInstallTargets({});
+ if (!targets) {
+ log.warn("Installation cancelled");
+ return;
+ }
+
+ const targetDirs = getTargetDirs(targets);
+
+ const installSpinner = ora("Installing skills...").start();
+
+ let installedCount = 0;
+ let permissionError = false;
+ const failedDirs: Set<string> = new Set();
+
+ for (const skill of uniqueSkills) {
+ try {
+ installSpinner.text = `Downloading ${skill.name}...`;
+ const downloadData = await downloadSkill(skill.project, skill.name);
+
+ if (downloadData.error) {
+ log.warn(`Failed to download ${skill.name}: ${downloadData.error}`);
+ continue;
+ }
+
+ installSpinner.text = `Installing ${skill.name}...`;
+
+ const [primaryDir, ...symlinkDirs] = targetDirs;
+
+ try {
+ await installSkillFiles(skill.name, downloadData.files, primaryDir);
+ } catch (dirErr) {
+ const error = dirErr as NodeJS.ErrnoException;
+ if (error.code === "EACCES" || error.code === "EPERM") {
+ permissionError = true;
+ failedDirs.add(primaryDir);
+ }
+ throw dirErr;
+ }
+
+ const primarySkillDir = join(primaryDir, skill.name);
+ for (const targetDir of symlinkDirs) {
+ try {
+ await symlinkSkill(skill.name, primarySkillDir, targetDir);
+ } catch (dirErr) {
+ const error = dirErr as NodeJS.ErrnoException;
+ if (error.code === "EACCES" || error.code === "EPERM") {
+ permissionError = true;
+ failedDirs.add(targetDir);
+ }
+ throw dirErr;
+ }
+ }
+
+ installedCount++;
+ } catch (err) {
+ const error = err as NodeJS.ErrnoException;
+ if (error.code === "EACCES" || error.code === "EPERM") {
+ continue;
+ }
+ const errMsg = err instanceof Error ? err.message : String(err);
+ log.warn(`Failed to install ${skill.name}: ${errMsg}`);
+ }
+ }
+
+ if (permissionError) {
+ installSpinner.fail("Permission denied");
+ log.blank();
+ log.warn("Fix permissions with:");
+ for (const dir of failedDirs) {
+ const parentDir = join(dir, "..");
+ log.dim(` sudo chown -R $(whoami) "${parentDir}"`);
+ }
+ log.blank();
+ return;
+ }
+
+ installSpinner.succeed(`Installed ${installedCount} skill(s)`);
+
+ const installedNames = uniqueSkills.map((s) => s.name);
+ logInstallSummary(targets, targetDirs, installedNames);
+}
+
+async function listCommand(options: ListOptions): Promise<void> {
+ const target = await promptForSingleTarget(options);
+ if (!target) {
+ log.warn("Cancelled");
+ return;
+ }
+
+ const skillsDir = getTargetDirFromSelection(target.ide, target.scope);
+
+ try {
+ const entries = await readdir(skillsDir, { withFileTypes: true });
+ const skillFolders = entries.filter((e) => e.isDirectory() || e.isSymbolicLink());
+
+ if (skillFolders.length === 0) {
+ log.warn(`No skills installed in ${skillsDir}`);
+ return;
+ }
+
+ log.info(`\n◆ Installed skills (${skillsDir}):`);
+
+ for (const folder of skillFolders) {
+ log.item(folder.name);
+ }
+
+ log.success(`${skillFolders.length} skill(s) installed\n`);
+ } catch {
+ log.warn(`No skills directory found at ${skillsDir}`);
+ }
+}
+
+async function removeCommand(name: string, options: RemoveOptions): Promise<void> {
+ const target = await promptForSingleTarget(options);
+ if (!target) {
+ log.warn("Cancelled");
+ return;
+ }
+
+ const skillsDir = getTargetDirFromSelection(target.ide, target.scope);
+ const skillPath = join(skillsDir, name);
+
+ try {
+ await rm(skillPath, { recursive: true });
+ log.success(`Removed skill: ${name}`);
+ } catch (err) {
+ const error = err as NodeJS.ErrnoException;
+ if (error.code === "ENOENT") {
+ log.error(`Skill not found: ${name}`);
+ } else if (error.code === "EACCES" || error.code === "EPERM") {
+ log.error(`Permission denied. Try: sudo rm -rf "${skillPath}"`);
+ } else {
+ log.error(`Failed to remove skill: ${error.message}`);
+ }
+ }
+}
+
+async function infoCommand(input: string): Promise<void> {
+ const parsed = parseSkillInput(input);
+ if (!parsed) {
+ log.blank();
+ log.error(`Invalid input format: ${input}`);
+ log.info(`Expected: /owner/repo or full GitHub URL`);
+ log.blank();
+ return;
+ }
+ const repo = `/${parsed.owner}/${parsed.repo}`;
+
+ log.blank();
+ const spinner = ora(`Fetching skills from ${repo}...`).start();
+
+ const data = await listProjectSkills(repo);
+
+ if (data.error) {
+ spinner.fail(pc.red(`Error: ${data.message || data.error}`));
+ return;
+ }
+
+ if (!data.skills || data.skills.length === 0) {
+ spinner.warn(pc.yellow(`No skills found in ${repo}`));
+ return;
+ }
+
+ spinner.succeed(`Found ${data.skills.length} skill(s)`);
+
+ log.blank();
+ for (const skill of data.skills) {
+ log.item(skill.name);
+ log.dim(` ${skill.description || "No description"}`);
+ log.dim(` URL: ${skill.url}`);
+ log.blank();
+ }
+
+ log.plain(
+ `${pc.bold("Quick commands:")}\n` +
+ ` Install all: ${pc.cyan(`ctx7 skills install ${repo} --all`)}\n` +
+ ` Install one: ${pc.cyan(`ctx7 skills install ${repo} ${data.skills[0]?.name}`)}\n`
+ );
+}
diff --git a/packages/cli/src/constants.ts b/packages/cli/src/constants.ts
new file mode 100644
index 00000000..87cd5285
--- /dev/null
+++ b/packages/cli/src/constants.ts
@@ -0,0 +1,9 @@
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, "../package.json"), "utf-8"));
+
+export const VERSION: string = pkg.version;
+export const NAME: string = pkg.name;
diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.ts
new file mode 100644
index 00000000..3d558550
--- /dev/null
+++ b/packages/cli/src/index.ts
@@ -0,0 +1,70 @@
+import { Command } from "commander";
+import pc from "picocolors";
+import figlet from "figlet";
+import { registerSkillCommands, registerSkillAliases } from "./commands/skill.js";
+import { setBaseUrl } from "./utils/api.js";
+import { VERSION } from "./constants.js";
+
+const brand = {
+ primary: pc.green,
+ dim: pc.dim,
+};
+
+const program = new Command();
+
+program
+ .name("ctx7")
+ .description("Context7 CLI - Manage AI coding skills and documentation context")
+ .version(VERSION)
+ .option("--base-url <url>")
+ .hook("preAction", (thisCommand) => {
+ const opts = thisCommand.opts();
+ if (opts.baseUrl) {
+ setBaseUrl(opts.baseUrl);
+ }
+ })
+ .addHelpText(
+ "after",
+ `
+Examples:
+ ${brand.dim("# Search for skills")}
+ ${brand.primary("npx ctx7 skills search pdf")}
+ ${brand.primary("npx ctx7 skills search react hooks")}
+
+ ${brand.dim("# Install from a repository")}
+ ${brand.primary("npx ctx7 skills install /anthropics/skills")}
+ ${brand.primary("npx ctx7 skills install /anthropics/skills pdf")}
+
+ ${brand.dim("# Install to specific client")}
+ ${brand.primary("npx ctx7 skills install /anthropics/skills --cursor")}
+ ${brand.primary("npx ctx7 skills install /anthropics/skills --global")}
+
+ ${brand.dim("# List and manage installed skills")}
+ ${brand.primary("npx ctx7 skills list --claude")}
+ ${brand.primary("npx ctx7 skills remove pdf")}
+
+Visit ${brand.primary("https://context7.com")} to browse skills
+`
+ );
+
+registerSkillCommands(program);
+registerSkillAliases(program);
+
+program.action(() => {
+ console.log("");
+ const banner = figlet.textSync("Context7", { font: "ANSI Shadow" });
+ console.log(brand.primary(banner));
+ console.log(brand.dim(" The open agent skills ecosystem"));
+ console.log("");
+
+ console.log(" Quick start:");
+ console.log(` ${brand.primary("npx ctx7 skills search pdf")}`);
+ console.log(` ${brand.primary("npx ctx7 skills install /anthropics/skills")}`);
+ console.log("");
+
+ console.log(` Run ${brand.primary("npx ctx7 --help")} for all commands and options`);
+ console.log(` Visit ${brand.primary("https://context7.com")} to browse skills`);
+ console.log("");
+});
+
+program.parse();
diff --git a/packages/cli/src/types.ts b/packages/cli/src/types.ts
new file mode 100644
index 00000000..0082b731
--- /dev/null
+++ b/packages/cli/src/types.ts
@@ -0,0 +1,102 @@
+export interface SkillFile {
+ path: string;
+ content: string;
+}
+
+export interface Skill {
+ name: string;
+ description: string;
+ url: string;
+}
+
+export interface SkillSearchResult extends Skill {
+ project: string;
+}
+
+export interface ListSkillsResponse {
+ project: string;
+ skills: Skill[];
+ error?: string;
+ message?: string;
+}
+
+export interface SingleSkillResponse extends Skill {
+ project: string;
+ error?: string;
+ message?: string;
+}
+
+export interface SearchResponse {
+ results: SkillSearchResult[];
+ error?: string;
+ message?: string;
+}
+
+export interface DownloadResponse {
+ skill: Skill & { project: string };
+ files: SkillFile[];
+ error?: string;
+}
+
+export type IDE = "claude" | "cursor" | "codex" | "opencode" | "amp" | "antigravity";
+
+export type Scope = "project" | "global";
+
+export interface IDEOptions {
+ claude?: boolean;
+ cursor?: boolean;
+ codex?: boolean;
+ opencode?: boolean;
+ amp?: boolean;
+ antigravity?: boolean;
+}
+
+export interface ScopeOptions {
+ global?: boolean;
+}
+
+export type AddOptions = IDEOptions & ScopeOptions & { all?: boolean };
+export type ListOptions = IDEOptions & ScopeOptions;
+export type RemoveOptions = IDEOptions & ScopeOptions;
+
+export interface InstallTargets {
+ ides: IDE[];
+ scopes: Scope[];
+}
+
+export const IDE_PATHS: Record<IDE, string> = {
+ claude: ".claude/skills",
+ cursor: ".cursor/skills",
+ codex: ".codex/skills",
+ opencode: ".opencode/skills",
+ amp: ".agents/skills",
+ antigravity: ".agent/skills",
+};
+
+export const IDE_GLOBAL_PATHS: Record<IDE, string> = {
+ claude: ".claude/skills",
+ cursor: ".cursor/skills",
+ codex: ".codex/skills",
+ opencode: ".config/opencode/skills",
+ amp: ".config/agents/skills",
+ antigravity: ".agent/skills",
+};
+
+export const IDE_NAMES: Record<IDE, string> = {
+ claude: "Claude Code",
+ cursor: "Cursor",
+ codex: "Codex",
+ opencode: "OpenCode",
+ amp: "Amp",
+ antigravity: "Antigravity",
+};
+
+export interface C7Config {
+ defaultIde: IDE;
+ defaultScope: "project" | "global";
+}
+
+export const DEFAULT_CONFIG: C7Config = {
+ defaultIde: "claude",
+ defaultScope: "project",
+};
diff --git a/packages/cli/src/utils/api.ts b/packages/cli/src/utils/api.ts
new file mode 100644
index 00000000..d76f4bfa
--- /dev/null
+++ b/packages/cli/src/utils/api.ts
@@ -0,0 +1,58 @@
+import type {
+ ListSkillsResponse,
+ SingleSkillResponse,
+ SearchResponse,
+ DownloadResponse,
+} from "../types.js";
+import { downloadSkillFromGitHub } from "./github.js";
+
+let baseUrl = "https://context7.com";
+
+export function setBaseUrl(url: string): void {
+ baseUrl = url;
+}
+
+export async function listProjectSkills(project: string): Promise<ListSkillsResponse> {
+ const params = new URLSearchParams({ project });
+ const response = await fetch(`${baseUrl}/api/v2/skills?${params}`);
+ return (await response.json()) as ListSkillsResponse;
+}
+
+export async function getSkill(project: string, skillName: string): Promise<SingleSkillResponse> {
+ const params = new URLSearchParams({ project, skill: skillName });
+ const response = await fetch(`${baseUrl}/api/v2/skills?${params}`);
+ return (await response.json()) as SingleSkillResponse;
+}
+
+export async function searchSkills(query: string): Promise<SearchResponse> {
+ const params = new URLSearchParams({ query });
+ const response = await fetch(`${baseUrl}/api/v2/skills?${params}`);
+ return (await response.json()) as SearchResponse;
+}
+
+export async function downloadSkill(project: string, skillName: string): Promise<DownloadResponse> {
+ const skillData = await getSkill(project, skillName);
+
+ if (skillData.error) {
+ return {
+ skill: { name: skillName, description: "", url: "", project },
+ files: [],
+ error: skillData.message || skillData.error,
+ };
+ }
+
+ const skill = {
+ name: skillData.name,
+ description: skillData.description,
+ url: skillData.url,
+ project: skillData.project,
+ };
+
+ const { files, error } = await downloadSkillFromGitHub(skill);
+
+ if (error) {
+ return { skill, files: [], error };
+ }
+
+ return { skill, files };
+}
diff --git a/packages/cli/src/utils/github.ts b/packages/cli/src/utils/github.ts
new file mode 100644
index 00000000..7606a732
--- /dev/null
+++ b/packages/cli/src/utils/github.ts
@@ -0,0 +1,140 @@
+import type { SkillFile, Skill } from "../types.js";
+
+const GITHUB_API = "https://api.github.com";
+const GITHUB_RAW = "https://raw.githubusercontent.com";
+
+interface GitHubTreeItem {
+ path: string;
+ mode: string;
+ type: "blob" | "tree";
+ sha: string;
+ size?: number;
+ url: string;
+}
+
+interface GitHubTreeResponse {
+ sha: string;
+ url: string;
+ tree: GitHubTreeItem[];
+ truncated: boolean;
+}
+
+function parseGitHubUrl(url: string): {
+ owner: string;
+ repo: string;
+ branch: string;
+ path: string;
+} | null {
+ try {
+ const urlObj = new URL(url);
+ const parts = urlObj.pathname.split("/").filter(Boolean);
+
+ // Handle raw.githubusercontent.com URLs
+ // Format: https://raw.githubusercontent.com/owner/repo/refs/heads/branch/path/SKILL.md
+ if (urlObj.hostname === "raw.githubusercontent.com") {
+ if (parts.length < 5) return null;
+
+ const owner = parts[0];
+ const repo = parts[1];
+
+ // Handle refs/heads/branch format
+ if (parts[2] === "refs" && parts[3] === "heads") {
+ const branch = parts[4];
+ // Get directory path (exclude the filename like SKILL.md)
+ const pathParts = parts.slice(5);
+ // Remove the last part if it looks like a file (has extension)
+ if (pathParts.length > 0 && pathParts[pathParts.length - 1].includes(".")) {
+ pathParts.pop();
+ }
+ const path = pathParts.join("/");
+ return { owner, repo, branch, path };
+ }
+
+ // Handle direct branch format: owner/repo/branch/path
+ const branch = parts[2];
+ const pathParts = parts.slice(3);
+ if (pathParts.length > 0 && pathParts[pathParts.length - 1].includes(".")) {
+ pathParts.pop();
+ }
+ const path = pathParts.join("/");
+ return { owner, repo, branch, path };
+ }
+
+ // Handle github.com tree URLs
+ // Format: https://github.com/owner/repo/tree/branch/path
+ if (urlObj.hostname === "github.com") {
+ if (parts.length < 4 || parts[2] !== "tree") return null;
+
+ const owner = parts[0];
+ const repo = parts[1];
+ const branch = parts[3];
+ const path = parts.slice(4).join("/");
+
+ return { owner, repo, branch, path };
+ }
+
+ return null;
+ } catch {
+ return null;
+ }
+}
+
+export async function downloadSkillFromGitHub(
+ skill: Skill & { project: string }
+): Promise<{ files: SkillFile[]; error?: string }> {
+ try {
+ const parsed = parseGitHubUrl(skill.url);
+
+ if (!parsed) {
+ return { files: [], error: `Invalid GitHub URL: ${skill.url}` };
+ }
+
+ const { owner, repo, branch, path: skillPath } = parsed;
+
+ const treeUrl = `${GITHUB_API}/repos/${owner}/${repo}/git/trees/${branch}?recursive=1`;
+ const treeResponse = await fetch(treeUrl, {
+ headers: {
+ Accept: "application/vnd.github.v3+json",
+ "User-Agent": "context7-cli",
+ },
+ });
+
+ if (!treeResponse.ok) {
+ return { files: [], error: `GitHub API error: ${treeResponse.status}` };
+ }
+
+ const treeData = (await treeResponse.json()) as GitHubTreeResponse;
+
+ const skillFiles = treeData.tree.filter(
+ (item) => item.type === "blob" && item.path.startsWith(skillPath + "/")
+ );
+
+ if (skillFiles.length === 0) {
+ return { files: [], error: `No files found in ${skillPath}` };
+ }
+
+ const files: SkillFile[] = [];
+ for (const item of skillFiles) {
+ const rawUrl = `${GITHUB_RAW}/${owner}/${repo}/${branch}/${item.path}`;
+ const fileResponse = await fetch(rawUrl);
+
+ if (!fileResponse.ok) {
+ console.warn(`Failed to fetch ${item.path}: ${fileResponse.status}`);
+ continue;
+ }
+
+ const content = await fileResponse.text();
+ const relativePath = item.path.slice(skillPath.length + 1);
+
+ files.push({
+ path: relativePath,
+ content,
+ });
+ }
+
+ return { files };
+ } catch (err) {
+ const message = err instanceof Error ? err.message : String(err);
+ return { files: [], error: message };
+ }
+}
diff --git a/packages/cli/src/utils/ide.ts b/packages/cli/src/utils/ide.ts
new file mode 100644
index 00000000..30d3159f
--- /dev/null
+++ b/packages/cli/src/utils/ide.ts
@@ -0,0 +1,215 @@
+import pc from "picocolors";
+import { select, checkbox } from "@inquirer/prompts";
+import { access } from "fs/promises";
+import { join } from "path";
+import { homedir } from "os";
+
+import { log } from "./logger.js";
+import type {
+ IDE,
+ IDEOptions,
+ Scope,
+ AddOptions,
+ ListOptions,
+ RemoveOptions,
+ InstallTargets,
+} from "../types.js";
+import { IDE_PATHS, IDE_GLOBAL_PATHS, IDE_NAMES, DEFAULT_CONFIG } from "../types.js";
+import { dirname } from "path";
+
+export function getSelectedIdes(options: IDEOptions): IDE[] {
+ const ides: IDE[] = [];
+ if (options.claude) ides.push("claude");
+ if (options.cursor) ides.push("cursor");
+ if (options.codex) ides.push("codex");
+ if (options.opencode) ides.push("opencode");
+ if (options.amp) ides.push("amp");
+ if (options.antigravity) ides.push("antigravity");
+ return ides;
+}
+
+export function hasExplicitIdeOption(options: IDEOptions): boolean {
+ return !!(
+ options.claude ||
+ options.cursor ||
+ options.codex ||
+ options.opencode ||
+ options.amp ||
+ options.antigravity
+ );
+}
+
+interface DetectedIdes {
+ ides: IDE[];
+ scope: Scope;
+}
+
+export async function detectInstalledIdes(preferredScope?: Scope): Promise<DetectedIdes | null> {
+ const allIdes = Object.keys(IDE_PATHS) as IDE[];
+
+ if (preferredScope === "global") {
+ const globalIdes: IDE[] = [];
+ for (const ide of allIdes) {
+ const detectionPath = dirname(IDE_GLOBAL_PATHS[ide]);
+ const globalParent = join(homedir(), detectionPath);
+ try {
+ await access(globalParent);
+ globalIdes.push(ide);
+ } catch {}
+ }
+ if (globalIdes.length > 0) {
+ return { ides: globalIdes, scope: "global" };
+ }
+ return null;
+ }
+
+ const projectIdes: IDE[] = [];
+ for (const ide of allIdes) {
+ const detectionPath = dirname(IDE_PATHS[ide]);
+ const projectParent = join(process.cwd(), detectionPath);
+ try {
+ await access(projectParent);
+ projectIdes.push(ide);
+ } catch {}
+ }
+
+ if (projectIdes.length > 0) {
+ return { ides: projectIdes, scope: "project" };
+ }
+
+ return null;
+}
+
+export async function promptForInstallTargets(options: AddOptions): Promise<InstallTargets | null> {
+ if (hasExplicitIdeOption(options)) {
+ const ides = getSelectedIdes(options);
+ const scope: Scope = options.global ? "global" : "project";
+ return {
+ ides: ides.length > 0 ? ides : [DEFAULT_CONFIG.defaultIde],
+ scopes: [scope],
+ };
+ }
+
+ const preferredScope: Scope | undefined = options.global ? "global" : undefined;
+ const detected = await detectInstalledIdes(preferredScope);
+
+ if (detected) {
+ const scope: Scope = options.global ? "global" : detected.scope;
+ return { ides: detected.ides, scopes: [scope] };
+ }
+
+ if (!options.global) {
+ return { ides: [DEFAULT_CONFIG.defaultIde], scopes: ["project"] };
+ }
+
+ log.blank();
+
+ const ideChoices = (Object.keys(IDE_NAMES) as IDE[]).map((ide) => ({
+ name: `${IDE_NAMES[ide]} ${pc.dim(`(${IDE_PATHS[ide]})`)}`,
+ value: ide,
+ checked: ide === DEFAULT_CONFIG.defaultIde,
+ }));
+
+ let selectedIdes: IDE[];
+ try {
+ selectedIdes = await checkbox({
+ message: "Which clients do you want to install the skill(s) for?",
+ choices: ideChoices,
+ required: true,
+ });
+ } catch {
+ return null;
+ }
+
+ if (selectedIdes.length === 0) {
+ log.warn("You must select at least one client");
+ return null;
+ }
+
+ const selectedScopes: Scope[] = options.global ? ["global"] : ["project"];
+
+ return { ides: selectedIdes, scopes: selectedScopes };
+}
+
+export async function promptForSingleTarget(
+ options: ListOptions | RemoveOptions
+): Promise<{ ide: IDE; scope: Scope } | null> {
+ if (hasExplicitIdeOption(options)) {
+ const ides = getSelectedIdes(options);
+ const ide = ides[0] || DEFAULT_CONFIG.defaultIde;
+ const scope: Scope = options.global ? "global" : "project";
+ return { ide, scope };
+ }
+
+ log.blank();
+
+ const ideChoices = (Object.keys(IDE_NAMES) as IDE[]).map((ide) => ({
+ name: `${IDE_NAMES[ide]} ${pc.dim(`(${IDE_PATHS[ide]})`)}`,
+ value: ide,
+ }));
+
+ let selectedIde: IDE;
+ try {
+ selectedIde = await select({
+ message: "Which client?",
+ choices: ideChoices,
+ default: DEFAULT_CONFIG.defaultIde,
+ });
+ } catch {
+ return null;
+ }
+
+ let selectedScope: Scope;
+ if (options.global !== undefined) {
+ selectedScope = options.global ? "global" : "project";
+ } else {
+ try {
+ selectedScope = await select({
+ message: "Which scope?",
+ choices: [
+ {
+ name: `Project ${pc.dim("(current directory)")}`,
+ value: "project" as Scope,
+ },
+ {
+ name: `Global ${pc.dim("(home directory)")}`,
+ value: "global" as Scope,
+ },
+ ],
+ default: DEFAULT_CONFIG.defaultScope,
+ });
+ } catch {
+ return null;
+ }
+ }
+
+ return { ide: selectedIde, scope: selectedScope };
+}
+
+export function getTargetDirs(targets: InstallTargets): string[] {
+ // Prioritize Claude to receive original files (others get symlinks)
+ const sortedIdes = [...targets.ides].sort((a, b) => {
+ if (a === "claude") return -1;
+ if (b === "claude") return 1;
+ return 0;
+ });
+
+ const dirs: string[] = [];
+ for (const ide of sortedIdes) {
+ for (const scope of targets.scopes) {
+ if (scope === "global") {
+ dirs.push(join(homedir(), IDE_GLOBAL_PATHS[ide]));
+ } else {
+ dirs.push(join(process.cwd(), IDE_PATHS[ide]));
+ }
+ }
+ }
+ return dirs;
+}
+
+export function getTargetDirFromSelection(ide: IDE, scope: Scope): string {
+ if (scope === "global") {
+ return join(homedir(), IDE_GLOBAL_PATHS[ide]);
+ }
+ return join(process.cwd(), IDE_PATHS[ide]);
+}
diff --git a/packages/cli/src/utils/installer.ts b/packages/cli/src/utils/installer.ts
new file mode 100644
index 00000000..4f7143cb
--- /dev/null
+++ b/packages/cli/src/utils/installer.ts
@@ -0,0 +1,38 @@
+import { mkdir, writeFile, rm, symlink, lstat } from "fs/promises";
+import { join } from "path";
+
+import type { SkillFile } from "../types.js";
+
+export async function installSkillFiles(
+ skillName: string,
+ files: SkillFile[],
+ targetDir: string
+): Promise<void> {
+ const skillDir = join(targetDir, skillName);
+
+ for (const file of files) {
+ const filePath = join(skillDir, file.path);
+ const fileDir = join(filePath, "..");
+
+ await mkdir(fileDir, { recursive: true });
+ await writeFile(filePath, file.content);
+ }
+}
+
+export async function symlinkSkill(
+ skillName: string,
+ sourcePath: string,
+ targetDir: string
+): Promise<void> {
+ const targetPath = join(targetDir, skillName);
+
+ try {
+ const stats = await lstat(targetPath);
+ if (stats.isSymbolicLink() || stats.isDirectory()) {
+ await rm(targetPath, { recursive: true });
+ }
+ } catch {}
+
+ await mkdir(targetDir, { recursive: true });
+ await symlink(sourcePath, targetPath);
+}
diff --git a/packages/cli/src/utils/logger.ts b/packages/cli/src/utils/logger.ts
new file mode 100644
index 00000000..922b7eb5
--- /dev/null
+++ b/packages/cli/src/utils/logger.ts
@@ -0,0 +1,13 @@
+import pc from "picocolors";
+
+export const log = {
+ info: (message: string) => console.log(pc.cyan(message)),
+ success: (message: string) => console.log(pc.green(`✔ ${message}`)),
+ warn: (message: string) => console.log(pc.yellow(`⚠ ${message}`)),
+ error: (message: string) => console.log(pc.red(`✖ ${message}`)),
+ dim: (message: string) => console.log(pc.dim(message)),
+ item: (message: string) => console.log(pc.green(` ${message}`)),
+ itemAdd: (message: string) => console.log(` ${pc.green("+")} ${message}`),
+ plain: (message: string) => console.log(message),
+ blank: () => console.log(""),
+};
diff --git a/packages/cli/src/utils/parse-input.ts b/packages/cli/src/utils/parse-input.ts
new file mode 100644
index 00000000..942b6915
--- /dev/null
+++ b/packages/cli/src/utils/parse-input.ts
@@ -0,0 +1,25 @@
+export interface ParsedSkillInput {
+ type: "repo" | "url";
+ owner: string;
+ repo: string;
+ branch?: string;
+ path?: string;
+}
+
+export function parseSkillInput(input: string): ParsedSkillInput | null {
+ const urlMatch = input.match(
+ /(?:https?:\/\/)?github\.com\/([^\/]+)\/([^\/]+)\/tree\/([^\/]+)\/(.+)/
+ );
+ if (urlMatch) {
+ const [, owner, repo, branch, path] = urlMatch;
+ return { type: "url", owner, repo, branch, path };
+ }
+
+ const shortMatch = input.match(/^\/?([^\/]+)\/([^\/]+)$/);
+ if (shortMatch) {
+ const [, owner, repo] = shortMatch;
+ return { type: "repo", owner, repo };
+ }
+
+ return null;
+}
diff --git a/packages/cli/tsconfig.json b/packages/cli/tsconfig.json
new file mode 100644
index 00000000..a5cb69cf
--- /dev/null
+++ b/packages/cli/tsconfig.json
@@ -0,0 +1,20 @@
+{
+ "compilerOptions": {
+ "target": "ES2022",
+ "module": "ESNext",
+ "moduleResolution": "bundler",
+ "lib": ["ES2022"],
+ "outDir": "./dist",
+ "rootDir": "./src",
+ "strict": true,
+ "esModuleInterop": true,
+ "skipLibCheck": true,
+ "forceConsistentCasingInFileNames": true,
+ "declaration": true,
+ "declarationMap": true,
+ "sourceMap": true,
+ "resolveJsonModule": true
+ },
+ "include": ["src/**/*"],
+ "exclude": ["node_modules", "dist"]
+}
diff --git a/packages/cli/tsup.config.ts b/packages/cli/tsup.config.ts
new file mode 100644
index 00000000..a2b42870
--- /dev/null
+++ b/packages/cli/tsup.config.ts
@@ -0,0 +1,12 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+ entry: ["src/index.ts"],
+ format: ["esm"],
+ dts: true,
+ clean: true,
+ sourcemap: true,
+ banner: {
+ js: "#!/usr/bin/env node",
+ },
+});
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index f154764b..94e0767f 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -39,6 +39,55 @@ importers:
specifier: ^8.28.0
+ packages/cli:
+ dependencies:
+ '@inquirer/prompts':
+ specifier: ^8.2.0
+ version: 8.2.0(@types/[email protected])
+ commander:
+ specifier: ^13.1.0
+ version: 13.1.0
+ figlet:
+ specifier: ^1.9.4
+ version: 1.9.4
+ ora:
+ specifier: ^9.0.0
+ version: 9.0.0
+ picocolors:
+ specifier: ^1.1.1
+ version: 1.1.1
+ devDependencies:
+ '@types/figlet':
+ specifier: ^1.7.0
+ version: 1.7.0
+ '@types/node':
+ specifier: ^22.19.1
+ version: 22.19.7
+ '@typescript-eslint/eslint-plugin':
+ specifier: ^8.28.0
+ '@typescript-eslint/parser':
+ specifier: ^8.28.0
+ eslint:
+ specifier: ^9.34.0
+ version: 9.39.1
+ eslint-plugin-prettier:
+ specifier: ^5.2.5
+ prettier:
+ specifier: ^3.6.2
+ version: 3.6.2
+ tsup:
+ specifier: ^8.5.0
+ typescript:
+ specifier: ^5.8.2
+ version: 5.9.3
+ typescript-eslint:
+ specifier: ^8.28.0
+
packages/mcp:
dependencies:
'@modelcontextprotocol/sdk':
@@ -590,6 +639,55 @@ packages:
resolution: {integrity: sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==}
engines: {node: '>=18.18'}
+ '@inquirer/[email protected]':
+ resolution: {integrity: sha512-g44zhR3NIKVs0zUesa4iMzExmZpLUdTLRMCStqX3GE5NT6VkPcxQGJ+uC8tDgBUC/vB1rUhUd55cOf++4NZcmw==}
+ engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+
+ '@inquirer/[email protected]':
+ resolution: {integrity: sha512-DrAMU3YBGMUAp6ArwTIp/25CNDtDbxk7UjIrrtM25JVVrlVYlVzHh5HR1BDFu9JMyUoZ4ZanzeaHqNDttf3gVg==}
+ engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+ peerDependencies:
+ '@types/node': '>=18'
+ peerDependenciesMeta:
+ '@types/node':
+ optional: true
+
+ '@inquirer/[email protected]':
+ resolution: {integrity: sha512-WdaPe7foUnoGYvXzH4jp4wH/3l+dBhZ3uwhKjXjwdrq5tEIFaANxj6zrGHxLdsIA0yKM0kFPVcEalOZXBB5ISA==}
+ engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+ peerDependencies:
+ '@types/node': '>=18'
+ peerDependenciesMeta:
+ '@types/node':
+ optional: true
+
+ '@inquirer/[email protected]':
+ resolution: {integrity: sha512-hV9o15UxX46OyQAtaoMqAOxGR8RVl1aZtDx1jHbCtSJy1tBdTfKxLPKf7utsE4cRy4tcmCQ4+vdV+ca+oNxqNA==}
+ engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+ peerDependencies:
+ '@types/node': '>=18'
+ peerDependenciesMeta:
+ '@types/node':
+ optional: true
+
+ '@inquirer/[email protected]':
+ resolution: {integrity: sha512-QI3Jfqcv6UO2/VJaEFONH8Im1ll++Xn/AJTBn9Xf+qx2M+H8KZAdQ5sAe2vtYlo+mLW+d7JaMJB4qWtK4BG3pw==}
+ engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+ peerDependencies:
+ '@types/node': '>=18'
+ peerDependenciesMeta:
+ '@types/node':
+ optional: true
+
+ '@inquirer/[email protected]':
+ resolution: {integrity: sha512-0I/16YwPPP0Co7a5MsomlZLpch48NzYfToyqYAOWtBmaXSB80RiNQ1J+0xx2eG+Wfxt0nHtpEWSRr6CzNVnOGg==}
+ engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+ peerDependencies:
+ '@types/node': '>=18'
+ peerDependenciesMeta:
+ '@types/node':
+ optional: true
+
'@inquirer/[email protected]':
resolution: {integrity: sha512-RWbSrDiYmO4LbejWY7ttpxczuwQyZLBUyygsA9Nsv95hpzUWwnNTVQmAq3xuh7vNwCp07UTmE5i11XAEExx4RA==}
engines: {node: '>=18'}
@@ -599,6 +697,91 @@ packages:
'@types/node':
optional: true
+ '@inquirer/[email protected]':
+ resolution: {integrity: sha512-LgyI7Agbda74/cL5MvA88iDpvdXI2KuMBCGRkbCl2Dg1vzHeOgs+s0SDcXV7b+WZJrv2+ERpWSM65Fpi9VfY3w==}
+ engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+ peerDependencies:
+ '@types/node': '>=18'
+ peerDependenciesMeta:
+ '@types/node':
+ optional: true
+
+ '@inquirer/[email protected]':
+ resolution: {integrity: sha512-y09iGt3JKoOCBQ3w4YrSJdokcD8ciSlMIWsD+auPu+OZpfxLuyz+gICAQ6GCBOmJJt4KEQGHuZSVff2jiNOy7g==}
+ engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+
+ '@inquirer/[email protected]':
+ resolution: {integrity: sha512-4B3s3jvTREDFvXWit92Yc6jF1RJMDy2VpSqKtm4We2oVU65YOh2szY5/G14h4fHlyQdpUmazU5MPCFZPRJ0AOw==}
+ engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+ peerDependencies:
+ '@types/node': '>=18'
+ peerDependenciesMeta:
+ '@types/node':
+ optional: true
+
+ '@inquirer/[email protected]':
+ resolution: {integrity: sha512-CmMp9LF5HwE+G/xWsC333TlCzYYbXMkcADkKzcawh49fg2a1ryLc7JL1NJYYt1lJ+8f4slikNjJM9TEL/AljYQ==}
+ engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+ peerDependencies:
+ '@types/node': '>=18'
+ peerDependenciesMeta:
+ '@types/node':
+ optional: true
+
+ '@inquirer/[email protected]':
+ resolution: {integrity: sha512-ZCEPyVYvHK4W4p2Gy6sTp9nqsdHQCfiPXIP9LbJVW4yCinnxL/dDDmPaEZVysGrj8vxVReRnpfS2fOeODe9zjg==}
+ engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+ peerDependencies:
+ '@types/node': '>=18'
+ peerDependenciesMeta:
+ '@types/node':
+ optional: true
+
+ '@inquirer/[email protected]':
+ resolution: {integrity: sha512-rqTzOprAj55a27jctS3vhvDDJzYXsr33WXTjODgVOru21NvBo9yIgLIAf7SBdSV0WERVly3dR6TWyp7ZHkvKFA==}
+ engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+ peerDependencies:
+ '@types/node': '>=18'
+ peerDependenciesMeta:
+ '@types/node':
+ optional: true
+
+ '@inquirer/[email protected]':
+ resolution: {integrity: sha512-CciqGoOUMrFo6HxvOtU5uL8fkjCmzyeB6fG7O1vdVAZVSopUBYECOwevDBlqNLyyYmzpm2Gsn/7nLrpruy9RFg==}
+ engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+ peerDependencies:
+ '@types/node': '>=18'
+ peerDependenciesMeta:
+ '@types/node':
+ optional: true
+
+ '@inquirer/[email protected]':
+ resolution: {integrity: sha512-EAzemfiP4IFvIuWnrHpgZs9lAhWDA0GM3l9F4t4mTQ22IFtzfrk8xbkMLcAN7gmVML9O/i+Hzu8yOUyAaL6BKA==}
+ engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+ peerDependencies:
+ '@types/node': '>=18'
+ peerDependenciesMeta:
+ '@types/node':
+ optional: true
+
+ '@inquirer/[email protected]':
+ resolution: {integrity: sha512-s8KoGpPYMEQ6WXc0dT9blX2NtIulMdLOO3LA1UKOiv7KFWzlJ6eLkEYTDBIi+JkyKXyn8t/CD6TinxGjyLt57g==}
+ engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+ peerDependencies:
+ '@types/node': '>=18'
+ peerDependenciesMeta:
+ '@types/node':
+ optional: true
+
+ '@inquirer/[email protected]':
+ resolution: {integrity: sha512-cKZN7qcXOpj1h+1eTTcGDVLaBIHNMT1Rz9JqJP5MnEJ0JhgVWllx7H/tahUp5YEK1qaByH2Itb8wLG/iScD5kw==}
+ engines: {node: '>=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0'}
+ peerDependencies:
+ '@types/node': '>=18'
+ peerDependenciesMeta:
+ '@types/node':
+ optional: true
+
'@jridgewell/[email protected]':
resolution: {integrity: sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==}
@@ -821,6 +1004,9 @@ packages:
resolution: {integrity: sha512-LuIQOcb6UmnF7C1PCFmEU1u2hmiHL43fgFQX67sN3H4Z+0Yk0Neo++mFsBjhOAuLzvlQeqAAkeDOZrJs9rzumQ==}
+ '@types/[email protected]':
+ resolution: {integrity: sha512-KwrT7p/8Eo3Op/HBSIwGXOsTZKYiM9NpWRBJ5sVjWP/SmlS+oxxRvJht/FNAtliJvja44N3ul1yATgohnVBV0Q==}
+
resolution: {integrity: sha512-r8Tayk8HJnX0FztbZN7oVqGccWgw98T/0neJphO91KkmOzug1KkofZURD4UaD5uH8AqcFLfdPErnBod0u71/qg==}
@@ -833,6 +1019,9 @@ packages:
resolution: {integrity: sha512-J8xLz7q2OFulZ2cyGTLE1TbbZcjpno7FaN6zdJNrgAdrJ+DZzh/uFR6YrTb4C+nXakvud8Q4+rbhoIWlYQbUFQ==}
+ '@types/[email protected]':
+ resolution: {integrity: sha512-MciR4AKGHWl7xwxkBa6xUGxQJ4VBOmPTF7sL+iGzuahOFaO0jHCsuEfS80pan1ef4gWId1oWOweIhrDEYLuaOw==}
+
resolution: {integrity: sha512-W609buLVRVmeW693xKfzHeIV6nJGGz98uCPfeXI1ELMLXVeKYZ9m15fAMSaUPBHYLGFsVRcMmSCksQOrZV9BYA==}
@@ -985,10 +1174,18 @@ packages:
resolution: {integrity: sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==}
engines: {node: '>=8'}
+ resolution: {integrity: sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==}
+ engines: {node: '>=12'}
+
resolution: {integrity: sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==}
engines: {node: '>=8'}
+ resolution: {integrity: sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==}
+ engines: {node: '>=12'}
+
resolution: {integrity: sha512-7UvmKalWRt1wgjL1RrGxoSJW/0QZFIegpeGvZG9kjp8vrRu55XTHbwnqq2GpXm9uLbcuhxm3IqX9OB4MZR1b2A==}
@@ -1064,6 +1261,10 @@ packages:
resolution: {integrity: sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==}
engines: {node: '>=10'}
+ resolution: {integrity: sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==}
+ engines: {node: ^12.17.0 || ^14.13 || >=16.0.0}
+
resolution: {integrity: sha512-PsezH1rqdV9VvyNhxxOW32/d75r01NY7TQCmOqomRo15ZSOKbpTFVsfjghxo6JloQUCGnH4k1LGu0R4yCLlWQQ==}
@@ -1075,6 +1276,18 @@ packages:
resolution: {integrity: sha512-NIxF55hv4nSqQswkAeiOi1r83xy8JldOFDTWiug55KBu9Jnblncd2U6ViHmYgHf01TPZS77NJBhBMKdWj9HQMQ==}
engines: {node: '>=8'}
+ resolution: {integrity: sha512-aCj4O5wKyszjMmDT4tZj93kxyydN/K5zPWSCe6/0AV/AA1pqe5ZBIw0a2ZfPQV7lL5/yb5HsUreJ6UFAF1tEQw==}
+ engines: {node: '>=18'}
+
+ resolution: {integrity: sha512-bXfOC4QcT1tKXGorxL3wbJm6XJPDqEnij2gQ2m7ESQuE+/z9YFIWnl/5RpTiKWbMq3EVKR4fRLJGn6DVfu0mpw==}
+ engines: {node: '>=18.20'}
+
+ resolution: {integrity: sha512-ouuZd4/dm2Sw5Gmqy6bGyNNNe1qt9RpmxveLSO7KcgsTnU7RXfsw+/bukWGo1abgBiMAic068rclZsO4IWmmxQ==}
+ engines: {node: '>= 12'}
+
resolution: {integrity: sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==}
engines: {node: '>=7.0.0'}
@@ -1082,6 +1295,10 @@ packages:
resolution: {integrity: sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==}
+ resolution: {integrity: sha512-/rFeCpNJQbhSZjGVwO9RFV3xPqbnERS8MmIQzCtD/zl6gpJuV/bMLuN92oG3F7d8oDEHHRrujSXNUr8fpjntKw==}
+ engines: {node: '>=18'}
+
resolution: {integrity: sha512-TywoWNNRbhoD0BXs1P3ZEScW8W5iKrnbithIl0YH+uCmBd0QpPOA8yc82DS3BIE5Ma6FnBVUsJ7wVUDz4dvOWQ==}
engines: {node: '>=20'}
@@ -1159,6 +1376,9 @@ packages:
resolution: {integrity: sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==}
+ resolution: {integrity: sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==}
+
resolution: {integrity: sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==}
engines: {node: '>= 0.8'}
@@ -1329,6 +1549,11 @@ packages:
picomatch:
optional: true
+ resolution: {integrity: sha512-uN6QE+TrzTAHC1IWTyrc4FfGo2KH/82J8Jl1tyKB7+z5DBit/m3D++Iu5lg91qJMnQQ3vpJrj5gxcK/pk4R9tQ==}
+ engines: {node: '>= 17.0.0'}
+ hasBin: true
+
resolution: {integrity: sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ==}
engines: {node: '>=16.0.0'}
@@ -1383,6 +1608,10 @@ packages:
resolution: {integrity: sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==}
+ resolution: {integrity: sha512-QZjmEOC+IT1uk6Rx0sX22V6uHWVwbdbxf1faPqJ1QhLdGgsRGCZoyaQBm/piRdJy/D2um6hM1UP7ZEeQ4EkP+Q==}
+ engines: {node: '>=18'}
+
resolution: {integrity: sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==}
engines: {node: '>= 0.4'}
@@ -1449,6 +1678,10 @@ packages:
resolution: {integrity: sha512-cf6L2Ds3h57VVmkZe+Pn+5APsT7FpqJtEhhieDCvrE2MK5Qk9MyffgQyuxQTm6BChfeZNtcOLHp9IcWRVcIcBQ==}
engines: {node: '>=0.10.0'}
+ resolution: {integrity: sha512-im9DjEDQ55s9fL4EYzOAv0yMqmMBSZp6G0VvFyTMPKWxiSBHUj9NW/qqLmXUwXrrM7AvqSlTCfvqRb0cM8yYqw==}
+ engines: {node: '>=0.10.0'}
+
resolution: {integrity: sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==}
engines: {node: '>= 4'}
@@ -1480,6 +1713,10 @@ packages:
resolution: {integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==}
engines: {node: '>=0.10.0'}
+ resolution: {integrity: sha512-qP1vozQRI+BMOPcjFzrjXuQvdak2pHNUMZoeG2eRbiSqyvbEf/wQtEOTOX1guk6E3t36RkaqiSt8A/6YElNxLQ==}
+ engines: {node: '>=12'}
+
resolution: {integrity: sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==}
engines: {node: '>=0.12.0'}
@@ -1491,6 +1728,10 @@ packages:
resolution: {integrity: sha512-2AT6j+gXe/1ueqbW6fLZJiIw3F8iXGJtt0yDrZaBhAZEG1raiTxKWU+IPqMCzQAXOUCKdA4UDMgacKH25XG2Cw==}
engines: {node: '>=4'}
+ resolution: {integrity: sha512-mE00Gnza5EEB3Ds0HfMyllZzbBrmLOX3vfWoj9A9PEnTfratQ/BcaJOuMhnkhjXvb2+FkY3VuHqtAGpTPmglFQ==}
+ engines: {node: '>=18'}
+
resolution: {integrity: sha512-eXK1UInq2bPmjyX6e3VHIzMLobc4J94i4AWn+Hpq3OU5KkrRC96OAcR3PRJ/pGu6m8TRnBHP9dkXQVsT/COVIA==}
engines: {node: '>=0.10.0'}
@@ -1566,6 +1807,10 @@ packages:
resolution: {integrity: sha512-+WKqsK294HMSc2jEbNgpHpd0JfIBhp7rEV4aqXWqFr6AlXov+SlcgB1Fv01y2kGe3Gc8nMW7VA0SrGuSkRfIEg==}
+ resolution: {integrity: sha512-ja1E3yCr9i/0hmBVaM0bfwDjnGy8I/s6PP4DFp+yP+a+mrHO4Rm7DtmnqROTUkHIkqffC84YY7AeqX6oFk0WFg==}
+ engines: {node: '>=18'}
+
resolution: {integrity: sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==}
@@ -1597,6 +1842,10 @@ packages:
resolution: {integrity: sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==}
engines: {node: '>=18'}
+ resolution: {integrity: sha512-VP79XUPxV2CigYP3jWwAUFSku2aKqBH7uTAapFWCBqutsbmDo96KY5o8uh6U+/YSIn5OxJnXp73beVkpqMIGhA==}
+ engines: {node: '>=18'}
+
resolution: {integrity: sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==}
@@ -1614,6 +1863,10 @@ packages:
resolution: {integrity: sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==}
+ resolution: {integrity: sha512-dkEJPVvun4FryqBmZ5KhDo0K9iDXAwn08tMLDinNdRBNPcYEDiWYysLcc6k3mjTMlbP9KyylvRpd4wFtwrT9rw==}
+ engines: {node: ^20.17.0 || >=22.9.0}
+
resolution: {integrity: sha512-z81GNO7nnYMEhrGh9LeymoE4+Yr0Wn5McHIZMK5cfQCl+NDX08sCZgUc9/6MHni9IWuFLm1Z3HTCXu2z9fN62Q==}
@@ -1647,10 +1900,18 @@ packages:
resolution: {integrity: sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==}
+ resolution: {integrity: sha512-VXJjc87FScF88uafS3JllDgvAm+c/Slfz06lorj2uAY34rlUu0Nt+v8wreiImcrgAjjIHp1rXpTDlLOGw29WwQ==}
+ engines: {node: '>=18'}
+
resolution: {integrity: sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==}
engines: {node: '>= 0.8.0'}
+ resolution: {integrity: sha512-m0pg2zscbYgWbqRR6ABga5c3sZdEon7bSgjnlXC64kxtxLOyjRcbbUkLj7HFyy/FTD+P2xdBWu8snGhYI0jc4A==}
+ engines: {node: '>=20'}
+
resolution: {integrity: sha512-/jHxFIzoMXdqPzTaCpFzAAWhpkSjZPF4Vsn6jAfNpmbH/ymsmd7Qc6VE9BGn0L6YMj6uwpQLxCECpus4ukKS9Q==}
@@ -1823,6 +2084,10 @@ packages:
resolution: {integrity: sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==}
engines: {node: '>=8'}
+ resolution: {integrity: sha512-oMA2dcrw6u0YfxJQXm342bFKX/E4sG9rbTzO9ptUcR/e8A33cHuvStiYOwH7fszkZlZ1z/ta9AAoPk2F4qIOHA==}
+ engines: {node: '>=18'}
+
resolution: {integrity: sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==}
engines: {iojs: '>=1.0.0', node: '>=0.10.0'}
@@ -1917,10 +2182,26 @@ packages:
resolution: {integrity: sha512-5GS12FdOZNliM5mAOxFRg7Ir0pWz8MdpYm6AY6VPkGpbA7ZzmbzNcBJQ0GPvvyWgcY7QAhCgf9Uy89I03faLkg==}
+ resolution: {integrity: sha512-UhDfHmA92YAlNnCfhmq0VeNL5bDbiZGg7sZ2IvPsXubGkiNa9EC+tUTsjBRsYUAz87btI6/1wf4XoVvQ3uRnmQ==}
+ engines: {node: '>=18'}
+
+ resolution: {integrity: sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==}
+ engines: {node: '>=18'}
+
+ resolution: {integrity: sha512-Kxl3KJGb/gxkaUMOjRsQ8IrXiGW75O4E3RPjFIINOVH8AMl2SQ/yWdTzWwF3FevIX9LcMAjJW+GRwAlAbTSXdg==}
+ engines: {node: '>=20'}
+
resolution: {integrity: sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==}
engines: {node: '>=8'}
+ resolution: {integrity: sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA==}
+ engines: {node: '>=12'}
+
resolution: {integrity: sha512-vavAMRXOgBVNF6nyEEmL3DBK19iRpDcoIwW+swQ+CbGiu7lju6t+JklA1MHweoWtadgt4ISVUsXLyDq34ddcwA==}
engines: {node: '>=4'}
@@ -2033,6 +2314,9 @@ packages:
resolution: {integrity: sha512-9a4/uxlTWJ4+a5i0ooc1rU7C7YOw3wT+UGqdeNNHWnOF9qcMBgLRS+4IYUqbczewFx4mLEig6gawh7X6mFlEkA==}
+ resolution: {integrity: sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==}
+
resolution: {integrity: sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==}
@@ -2143,6 +2427,10 @@ packages:
resolution: {integrity: sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==}
engines: {node: '>=0.10.0'}
+ resolution: {integrity: sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==}
+ engines: {node: '>=18'}
+
resolution: {integrity: sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==}
@@ -2150,6 +2438,10 @@ packages:
resolution: {integrity: sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==}
engines: {node: '>=10'}
+ resolution: {integrity: sha512-CzhO+pFNo8ajLM2d2IW/R93ipy99LWjtwblvC1RsoSUMZgyLbYFr221TnSNT7GjGdYui6P459mw9JH/g/zW2ug==}
+ engines: {node: '>=18'}
+
resolution: {integrity: sha512-HvWtU2UG41LALjajJrML6uQejQhNJx+JBO9IflpSja4R03iNWfKXrj6W2h7ljuLyc1nKS+9yDyL/9tD1U/yBnQ==}
peerDependencies:
@@ -2574,6 +2866,51 @@ snapshots:
'@humanwhocodes/[email protected]': {}
+ '@inquirer/[email protected]': {}
+
+ '@inquirer/[email protected](@types/[email protected])':
+ dependencies:
+ '@inquirer/ansi': 2.0.3
+ '@inquirer/core': 11.1.1(@types/[email protected])
+ '@inquirer/figures': 2.0.3
+ '@inquirer/type': 4.0.3(@types/[email protected])
+ optionalDependencies:
+ '@types/node': 22.19.7
+
+ '@inquirer/[email protected](@types/[email protected])':
+ dependencies:
+ '@inquirer/core': 11.1.1(@types/[email protected])
+ '@inquirer/type': 4.0.3(@types/[email protected])
+ optionalDependencies:
+ '@types/node': 22.19.7
+
+ '@inquirer/[email protected](@types/[email protected])':
+ dependencies:
+ '@inquirer/ansi': 2.0.3
+ '@inquirer/figures': 2.0.3
+ '@inquirer/type': 4.0.3(@types/[email protected])
+ cli-width: 4.1.0
+ mute-stream: 3.0.0
+ signal-exit: 4.1.0
+ wrap-ansi: 9.0.2
+ optionalDependencies:
+ '@types/node': 22.19.7
+
+ '@inquirer/[email protected](@types/[email protected])':
+ dependencies:
+ '@inquirer/core': 11.1.1(@types/[email protected])
+ '@inquirer/external-editor': 2.0.3(@types/[email protected])
+ '@inquirer/type': 4.0.3(@types/[email protected])
+ optionalDependencies:
+ '@types/node': 22.19.7
+
+ '@inquirer/[email protected](@types/[email protected])':
+ dependencies:
+ '@inquirer/core': 11.1.1(@types/[email protected])
+ '@inquirer/type': 4.0.3(@types/[email protected])
+ optionalDependencies:
+ '@types/node': 22.19.7
+
dependencies:
chardet: 2.1.1
@@ -2581,6 +2918,80 @@ snapshots:
optionalDependencies:
'@types/node': 25.0.3
+ '@inquirer/[email protected](@types/[email protected])':
+ dependencies:
+ chardet: 2.1.1
+ iconv-lite: 0.7.2
+ optionalDependencies:
+ '@types/node': 22.19.7
+
+ '@inquirer/[email protected]': {}
+
+ '@inquirer/[email protected](@types/[email protected])':
+ dependencies:
+ '@inquirer/core': 11.1.1(@types/[email protected])
+ '@inquirer/type': 4.0.3(@types/[email protected])
+ optionalDependencies:
+ '@types/node': 22.19.7
+
+ '@inquirer/[email protected](@types/[email protected])':
+ dependencies:
+ '@inquirer/core': 11.1.1(@types/[email protected])
+ '@inquirer/type': 4.0.3(@types/[email protected])
+ optionalDependencies:
+ '@types/node': 22.19.7
+
+ '@inquirer/[email protected](@types/[email protected])':
+ dependencies:
+ '@inquirer/ansi': 2.0.3
+ '@inquirer/core': 11.1.1(@types/[email protected])
+ '@inquirer/type': 4.0.3(@types/[email protected])
+ optionalDependencies:
+ '@types/node': 22.19.7
+
+ '@inquirer/[email protected](@types/[email protected])':
+ dependencies:
+ '@inquirer/checkbox': 5.0.4(@types/[email protected])
+ '@inquirer/confirm': 6.0.4(@types/[email protected])
+ '@inquirer/editor': 5.0.4(@types/[email protected])
+ '@inquirer/expand': 5.0.4(@types/[email protected])
+ '@inquirer/input': 5.0.4(@types/[email protected])
+ '@inquirer/number': 4.0.4(@types/[email protected])
+ '@inquirer/password': 5.0.4(@types/[email protected])
+ '@inquirer/rawlist': 5.2.0(@types/[email protected])
+ '@inquirer/search': 4.1.0(@types/[email protected])
+ '@inquirer/select': 5.0.4(@types/[email protected])
+ optionalDependencies:
+ '@types/node': 22.19.7
+
+ '@inquirer/[email protected](@types/[email protected])':
+ dependencies:
+ '@inquirer/core': 11.1.1(@types/[email protected])
+ '@inquirer/type': 4.0.3(@types/[email protected])
+ optionalDependencies:
+ '@types/node': 22.19.7
+
+ '@inquirer/[email protected](@types/[email protected])':
+ dependencies:
+ '@inquirer/core': 11.1.1(@types/[email protected])
+ '@inquirer/figures': 2.0.3
+ '@inquirer/type': 4.0.3(@types/[email protected])
+ optionalDependencies:
+ '@types/node': 22.19.7
+
+ '@inquirer/[email protected](@types/[email protected])':
+ dependencies:
+ '@inquirer/ansi': 2.0.3
+ '@inquirer/core': 11.1.1(@types/[email protected])
+ '@inquirer/figures': 2.0.3
+ '@inquirer/type': 4.0.3(@types/[email protected])
+ optionalDependencies:
+ '@types/node': 22.19.7
+
+ '@inquirer/[email protected](@types/[email protected])':
+ optionalDependencies:
+ '@types/node': 22.19.7
+
'@jridgewell/[email protected]':
dependencies:
'@jridgewell/sourcemap-codec': 1.5.5
@@ -2793,6 +3204,8 @@ snapshots:
'@types/express-serve-static-core': 5.1.0
'@types/serve-static': 1.15.10
+ '@types/[email protected]': {}
+
'@types/[email protected]': {}
'@types/[email protected]': {}
@@ -2801,6 +3214,10 @@ snapshots:
'@types/[email protected]': {}
+ '@types/[email protected]':
+ dependencies:
+ undici-types: 6.21.0
+
dependencies:
undici-types: 7.16.0
@@ -2999,10 +3416,14 @@ snapshots:
+
dependencies:
color-convert: 2.0.1
+
@@ -3078,6 +3499,8 @@ snapshots:
ansi-styles: 4.3.0
supports-color: 7.2.0
+
@@ -3086,12 +3509,22 @@ snapshots:
+ dependencies:
+ restore-cursor: 5.1.0
+
+
+
dependencies:
color-name: 1.1.4
+
@@ -3145,6 +3578,8 @@ snapshots:
+
@@ -3383,6 +3818,10 @@ snapshots:
optionalDependencies:
picomatch: 4.0.3
+ dependencies:
+ commander: 14.0.2
+
dependencies:
flat-cache: 4.0.1
@@ -3446,6 +3885,8 @@ snapshots:
+
dependencies:
call-bind-apply-helpers: 1.0.2
@@ -3517,6 +3958,10 @@ snapshots:
dependencies:
safer-buffer: 2.1.2
+ dependencies:
+ safer-buffer: 2.1.2
+
@@ -3538,6 +3983,8 @@ snapshots:
dependencies:
is-extglob: 2.1.1
+
@@ -3546,6 +3993,8 @@ snapshots:
dependencies:
better-path-resolve: 1.0.0
+
@@ -3606,6 +4055,11 @@ snapshots:
+ dependencies:
+ is-unicode-supported: 2.1.0
+ yoctocolors: 2.1.2
+
dependencies:
'@jridgewell/sourcemap-codec': 1.5.5
@@ -3629,6 +4083,8 @@ snapshots:
dependencies:
mime-db: 1.54.0
+
dependencies:
brace-expansion: 1.1.12
@@ -3648,6 +4104,8 @@ snapshots:
+
dependencies:
any-promise: 1.3.0
@@ -3674,6 +4132,10 @@ snapshots:
dependencies:
wrappy: 1.0.2
+ dependencies:
+ mimic-function: 5.0.1
+
dependencies:
deep-is: 0.1.4
@@ -3683,6 +4145,18 @@ snapshots:
type-check: 0.4.0
word-wrap: 1.2.5
+ dependencies:
+ chalk: 5.6.2
+ cli-cursor: 5.0.0
+ cli-spinners: 3.4.0
+ is-interactive: 2.0.0
+ is-unicode-supported: 2.1.0
+ log-symbols: 7.0.1
+ stdin-discarder: 0.2.2
+ string-width: 8.1.0
+ strip-ansi: 7.1.2
+
@@ -3808,6 +4282,11 @@ snapshots:
+ dependencies:
+ onetime: 7.0.0
+ signal-exit: 4.1.0
+
@@ -3940,10 +4419,27 @@ snapshots:
+
+ dependencies:
+ emoji-regex: 10.6.0
+ get-east-asian-width: 1.4.0
+ strip-ansi: 7.1.2
+
+ dependencies:
+ get-east-asian-width: 1.4.0
+ strip-ansi: 7.1.2
+
dependencies:
ansi-regex: 5.0.1
+ dependencies:
+ ansi-regex: 6.2.2
+
@@ -4056,6 +4552,8 @@ snapshots:
+
@@ -4131,10 +4629,18 @@ snapshots:
+ dependencies:
+ ansi-styles: 6.2.3
+ string-width: 7.2.0
+ strip-ansi: 7.1.2
+
+
dependencies:
zod: 4.3.5