CLI reference
The nuclexa CLI is the primary way to install, export, search, publish, and manage packages. Run it without installing anything via npx:
bash
npx nuclexa <command> [args] [flags]Commands
| Command | Description |
|---|---|
install <package> | Install a package to a target. Accepts name or name@version. |
export <package> | Export a package to a tool's native format (OpenAI Agents, Copilot, …). |
search <query> | Search the registry and print matching packages. |
publish | Publish the package in the current directory. |
list | List packages installed in the current project. |
uninstall <package> | Remove an installed package from a target. |
update [package] | Update one package, or all packages if omitted. |
Flags
| Flag | Applies to | Description |
|---|---|---|
--target <t> | install, export, uninstall, update, list | Platform target: claude-code, claude-desktop, cursor, windsurf, openai-agents, gemini-cli, copilot-instructions, replit-agent, mcp. |
--yes, -y | install, uninstall, update | Skip the permission confirmation prompt. |
--version <v> | install | Install a specific version (alternative to name@version). |
--limit <n> | search | Limit the number of search results. |
--json | all | Print machine-readable JSON. |
--dry-run | install, publish, update | Show what would happen without writing anything. |
--global, -g | install, list | Operate on the global Nuclexa directory. |
Examples
bash
# Install the latest version into Claude Code
npx nuclexa install security-review --target claude-code
# Install a pinned version into Cursor, skipping the prompt
npx nuclexa install react-refactor-rules@3.2.1 --target cursor --yes
# Export a package as Copilot instructions
npx nuclexa export github-copilot-review --target copilot-instructions
# Find MCP servers
npx nuclexa search mcp --limit 5 --json
# Publish the package in the current directory
npx nuclexa publishExit codes
| Code | Meaning |
|---|---|
0 | Success |
1 | Generic error (validation, network, etc.) |
2 | Package not found |
3 | Permission confirmation declined |
See Installation targets for per-platform paths, and the Publishing guide for the full publish workflow.