@skill-vault/cli

The official command-line interface for SkillVault, an open-source AI component marketplace.

This CLI allows developers to reliably and efficiently pull AI prompts, code snippets, and JSON configurations directly into their working directory.

Usage

You don't need to install anything globally. You can run the CLI directly via npx (or pnpx, bunx):

npx @skill-vault/cli install <component-id>

Example:

npx @skill-vault/cli install 5

This will:

1. Fetch component #5 from the SkillVault API.
2. Intelligently save the payload with the correct name and file extension (e.g., component-name.md or component-name.json).
3. Increment the download tracker on the marketplace.

Environment Variables

By default, the CLI connects to the production SkillVault instance.

You can override the target API URL by exporting:

export SKILLVAULT_API_URL="https://your-domain.com/api/v1/components"

How it works

This package is a thin Node.js wrapper that natively bundles pre-compiled Go binaries for windows, linux, and darwin (macOS) across amd64 and arm64 architectures. When you run the npx command, it automatically detects your OS and architecture, and spawns the correct statically-linked binary, meaning you get the speed of Go with the distribution convenience of NPM.

License

This project is open-source.