Install, configure, and use the Shipables command-line interface.
CLI Overview
The Shipables CLI is the primary way to install, manage, and publish AI agent skills from the command line.
Installation
Use npx to run without installing:
npx @senso-ai/shipables <command>
Or install globally:
npm install -g @senso-ai/shipables
Commands
| Command | Description |
|---|---|
| install | Install a skill from the registry |
| init | Scaffold a new skill in the current directory |
| publish | Publish a skill to the registry |
| search | Search the registry for skills |
| info | Show detailed information about a skill |
| list | List installed skills |
| update | Update installed skills to latest versions |
| uninstall | Remove an installed skill |
| unpublish | Yank a published version |
| delete | Permanently delete a skill |
Global options
-V, --version Show version number
-h, --help Show help for a command
Configuration
The CLI stores configuration in ~/.shipables/:
| File | Purpose |
|---|---|
config.json | Auth token, registry URL, default agents, scope |
installed.json | Record of all installed skills per project |
cache/ | Downloaded tarball cache |
Use shipables config list to view your current configuration. See config for details.
Agent auto-detection
When you run shipables install, the CLI automatically detects which AI agents are installed on your system by checking for:
- Binaries in PATH — e.g.,
claude,codex,gemini - Configuration directories — e.g.,
~/.claude,.cursor,.vscode
If multiple agents are detected, you'll be prompted to choose which ones to install for. You can skip this by using explicit agent flags (--claude, --cursor, etc.) or --all.
See Agent Guides for details on each supported agent.