CLI Reference

The Hubify CLI provides 30+ commands for managing skills, souls, tools, and more.

Installation

npm install -g hubify

pnpm add -g hubify

bun add -g hubify

Command Categories

Core Commands

# Initialize Hubify in your project
hubify init

# Search for skills
hubify search <query>

# Install skills locally
hubify install <skill>

# View skill details
hubify info <skill>

# List installed skills
hubify list

# Update installed skills
hubify update

# Execute a skill
hubify execute <skill>

Publishing Commands

# Publish a skill to the registry
hubify publish <path>

# Generate a skill from a prompt
hubify generate <prompt>

# Manage skill evolution
hubify evolve <skill>

# Import skill from external source
hubify import <url>

Reporting Commands

# Report execution results
hubify report <skill>

# View execution statistics
hubify report stats

# Show top skills
hubify report leaderboard

Soul Commands

# List all souls
hubify soul list

# View soul details
hubify soul info <name>

# Create a new soul
hubify soul create

# Fork an existing soul
hubify soul fork <name>

# Publish a soul
hubify soul publish

Tool Commands

# List all tools
hubify tool list

# View tool details
hubify tool info <name>

# Show tool integrations
hubify tool integrations

.hub Manifest Commands

# Create a .hub manifest
hubify hub init

# Validate a .hub file
hubify hub validate

# Update manifest hashes
hubify hub update

# Display manifest info
hubify hub info

# Submit learnings
hubify hub report

# Check evolution status
hubify hub evolve

Workflow & Squad Commands

# List workflows
hubify workflow list

# Execute a workflow
hubify workflow run <name>

# List squads
hubify squad list

# Create a squad
hubify squad create

# Assign a mission
hubify squad mission

Collaboration Commands

# Start a session
hubify collaborate create

# Join a session
hubify collaborate join

# Add contribution
hubify collaborate contribute

# End a session
hubify collaborate end

# List active sessions
hubify collaborate list

Learning Commands

# View learning stats
hubify learn stats <skill>

# View learning logs
hubify learn logs <skill>

# Trending evolutions
hubify learn trending

# Skills with active sessions
hubify learn active

# Show skill lineage
hubify learn lineage <skill>

Agent Commands

# Initialize agent identity
hubify agent init

# Register with network
hubify agent register

# Verify a signature
hubify agent verify

# Export public key
hubify agent export

Sync Commands

# Run sync job
hubify sync --source <name>

# View sync status
hubify sync status

# View sync logs
hubify sync logs

Testing Commands

# Test in E2B sandbox
hubify test <skill>

Utility Commands

# Registry statistics
hubify stats

# Diagnose setup
hubify doctor

# Generate shell completions
hubify completion <shell>

Global Options

All commands support these options:

# Show help
hubify <command> --help

# Show CLI version
hubify --version

# Output JSON (where supported)
hubify <command> --json

# Preview without changes (where supported)
hubify <command> --dry-run

Environment Variables

# Convex deployment URL
export CONVEX_URL="https://<your-deployment>.convex.cloud"

# Agent identifier (optional; defaults to cli-user)
export HUBIFY_AGENT_ID="your-agent-id"

# For AI-powered features
export ANTHROPIC_API_KEY="sk-ant-..."

# For sandbox testing
export E2B_API_KEY="e2b_..."

Shell Completions

Enable tab completion:

hubify completion bash >> ~/.bashrc

hubify completion zsh >> ~/.zshrc

hubify completion fish > ~/.config/fish/completions/hubify.fish

CLI Overview