CLI Reference
Complete command-line reference for the clawhub CLI
Commands
Usage
clawhub [command] [options]
Global Options
These options work with all commands:
| Option | Alias | Description |
|---|---|---|
--version | -v | Display version number |
--help | -h | Display help information |
--verbose | Show detailed output | |
--quiet | -q | Suppress non-error output |
--json | Output results as JSON |
install
Install a skill from the ZhenSkill registry.
Usage
clawhub install [skill-name] [options]
Options
| Option | Description |
|---|---|
--version [version] | Install specific version (default: latest) |
--force | Force reinstall if already installed |
--no-deps | Skip dependency installation |
--global | Install globally for all Claude projects |
Examples
# Install the latest version
clawhub install video-generator
# Install a specific version
clawhub install video-generator --version 2.1.0
# Force reinstall
clawhub install video-generator --force
# Install globally
clawhub install video-generator --global
list
List all installed skills.
Usage
clawhub list [options]
Options
| Option | Description |
|---|---|
--global | List globally installed skills |
--outdated | Show only skills with available updates |
--json | Output as JSON |
Examples
# List all installed skills
clawhub list
# Show only outdated skills
clawhub list --outdated
# Output as JSON
clawhub list --json
Output Format
The list command displays:
- Skill name
- Installed version
- Latest available version
- Installation status
search
Search for skills in the ZhenSkill registry.
Usage
clawhub search [query] [options]
Options
| Option | Description |
|---|---|
--category [name] | Filter by category |
--limit [number] | Limit number of results (default: 20) |
--featured | Show only featured skills |
--sort [field] | Sort by: downloads, rating, date (default: relevance) |
Examples
# Search for video-related skills
clawhub search video
# Search in a specific category
clawhub search video --category video-media
# Show featured skills only
clawhub search --featured
# Sort by downloads
clawhub search --sort downloads
update
Update an installed skill to the latest version.
Usage
clawhub update [skill-name] [options]
Options
| Option | Description |
|---|---|
--all | Update all installed skills |
--version [version] | Update to specific version |
--self | Update clawhub CLI itself |
--dry-run | Show what would be updated without updating |
Examples
# Update a specific skill
clawhub update video-generator
# Update all skills
clawhub update --all
# Update to a specific version
clawhub update video-generator --version 2.0.0
# Update clawhub CLI
clawhub update --self
# Preview updates without applying
clawhub update --all --dry-run
remove
Remove an installed skill.
Usage
clawhub remove [skill-name] [options]
Aliases
uninstall, rm
Options
| Option | Description |
|---|---|
--force | Force removal without confirmation |
--keep-config | Keep configuration files |
Examples
# Remove a skill (with confirmation)
clawhub remove video-generator
# Force remove without confirmation
clawhub remove video-generator --force
# Remove but keep config
clawhub remove video-generator --keep-config
info
Display detailed information about a skill.
Usage
clawhub info [skill-name] [options]
Options
| Option | Description |
|---|---|
--json | Output as JSON |
--versions | Show all available versions |
Examples
# Show skill information
clawhub info video-generator
# Show all versions
clawhub info video-generator --versions
# Output as JSON
clawhub info video-generator --json
Information Displayed
- Skill name and description
- Current version and latest version
- Author and maintainer
- License and platform support
- Dependencies
- Installation status
- Download count and rating
- Repository and homepage URLs
config
View and modify clawhub configuration.
Usage
clawhub config [action] [key] [value]
Actions
| Action | Description |
|---|---|
get [key] | Get a configuration value |
set [key] [value] | Set a configuration value |
delete [key] | Delete a configuration key |
list | List all configuration values |
Examples
# Show all configuration
clawhub config
# Get a specific value
clawhub config get skillsDirectory
# Set a value
clawhub config set autoUpdate false
# Delete a key
clawhub config delete customRegistry
Configuration Keys
| Key | Description | Default |
|---|---|---|
claudeCodePath | Claude Code installation path | Auto-detected |
skillsDirectory | Skills installation directory | ~/.clawhub/skills |
registry | ZhenSkill registry URL | https://www.zhenskill.com/api |
autoUpdate | Auto-update skills | true |
setup
Run the interactive setup wizard to configure clawhub.
Usage
clawhub setup [options]
Options
| Option | Description |
|---|---|
--force | Force reconfiguration |
--reset | Reset to default configuration |
Examples
# Run setup wizard
clawhub setup
# Force reconfiguration
clawhub setup --force
# Reset to defaults
clawhub setup --reset
Environment Variables
clawhub respects the following environment variables:
| Variable | Description |
|---|---|
CLAWHUB_HOME | Override default clawhub home directory |
CLAWHUB_REGISTRY | Override default registry URL |
CLAWHUB_TOKEN | Authentication token for private registries |
NO_COLOR | Disable colored output |
Exit Codes
clawhub uses the following exit codes:
| Code | Meaning |
|---|---|
0 | Success |
1 | Generic error |
2 | Configuration error |
3 | Network error |
4 | Skill not found |
5 | Installation error |