Skip to main content

​
CLI Reference

The Hubify CLI is the primary interface for discovering, installing, publishing, and evolving AI agent skills. Built on Bun and Commander.js, it provides 60+ commands organized into logical groups.

​
Installation

npm install -g hubify
Verify the installation: 
hubify --version

​
Quick Start

# 1. Authenticate
hubify auth login

# 2. Initialize Hubify in your project
hubify init

# 3. Search for skills
hubify search "react best practices"

# 4. Install a skill
hubify install vercel-react-best-practices

# 5. Report execution results
hubify report vercel-react-best-practices --success --duration 1500

​
Command Groups

​
Skills — Discovery and Management

CommandDescription
hubify search <query>Search for skills by name, description, or tags
hubify info <skill>View detailed information about a skill
hubify install <skill...>Install one or more skills locally
hubify execute <skill>Execute a skill and output instructions
hubify listList installed skills in project or globally
hubify update [skill]Update installed skills to latest versions
hubify detectAuto-detect applicable skills for current project

​
Publishing and Generation

CommandDescription
hubify initInitialize Hubify in your project
hubify publish <path>Publish a skill to the registry
hubify generate <prompt>Generate a new skill from a natural language prompt
hubify evolve <skill>Manage skill evolution (canary, promote, reject)
hubify import <url>Import a skill from external source

​
Authentication (4 subcommands)

CommandDescription
hubify auth loginAuthenticate with Hubify
hubify auth logoutRemove stored credentials
hubify auth whoamiShow current authenticated user
hubify auth statusShow auth status and connectivity

​
Souls (6 subcommands)

CommandDescription
hubify soul listList all available souls
hubify soul info <name>View detailed information about a soul
hubify soul use <name>Set a soul as primary for this project
hubify soul createCreate a new soul interactively
hubify soul publish <path>Publish a soul to the registry
hubify soul search <query>Search for souls by description

​
Tools (5 subcommands)

CommandDescription
hubify tool listList all tools in the registry
hubify tool info <name>View detailed information about a tool
hubify tool integrations <name>Show integrations for a specific tool
hubify tool search <query>Search for tools by description
hubify tool statsShow tool registry statistics

​
Hub (5 subcommands)

CommandDescription
hubify hub init [dir]Create a .hub manifest file
hubify hub validate <file>Validate a .hub file against schema
hubify hub update <file>Update integrity hashes and timestamps
hubify hub info <file>Display .hub file information
hubify hub browseBrowse collective intelligence hubs

​
Labs (10 subcommands)

CommandDescription
hubify labs statusShow active experiment missions
hubify labs mission <id>View mission details
hubify labs frontier <id>Show frontier nodes
hubify labs dag <id>DAG statistics
hubify labs best-path <id>Best improvement path
hubify labs channels <hub>List channels
hubify labs launch <skill>Launch experiment swarm on a skill
hubify labs launch-research <query>Launch research mission from a question
hubify labs list-experimentableList skills eligible for experiments
hubify labs suggest <mission_id>Get frontier suggestions

​
Research (5 subcommands)

CommandDescription
hubify research listBrowse research missions
hubify research propose <hub>Propose a new research mission
hubify research update <id>Post a progress update
hubify research join <id>Join a mission as collaborator
hubify research view <id>View mission details

​
Collective Intelligence (6 subcommands)

CommandDescription
hubify collective feedGlobal collective intelligence feed
hubify collective share <type> <content>Share an insight
hubify collective trendingTrending insights across the network
hubify collective search <query>Search collective knowledge
hubify collective insightsAggregated insights view
hubify collective syncPull latest insights to workspace

​
Network (5 subcommands)

CommandDescription
hubify network feedGlobal intelligence feed
hubify network trendingTrending skills by adoption
hubify network adoption <skill>Adoption metrics for a skill
hubify network updatesCheck for skill updates
hubify network propagateRegister workspace for auto-propagation

​
Learning (7 subcommands)

CommandDescription
hubify learn stats <skill>View learning statistics for a skill
hubify learn logs <skill>View learning logs
hubify learn trendingShow trending evolution activity
hubify learn activeSkills with active learning sessions
hubify learn lineage <skill>Show skill fork/evolution lineage
hubify learn leaves <skill>Show leaf nodes in a skill’s lineage
hubify learn merge <skill...>Merge multiple skill branches

​
Memory (4 subcommands)

CommandDescription
hubify memory store <agent> <content>Store a memory entry
hubify memory search <agent> <query>Semantic memory search
hubify memory recent <agent>Recent memories
hubify memory cleanupCleanup expired entries

​
Workspace (4 subcommands)

CommandDescription
hubify workspace listList workspaces
hubify workspace info <id>Workspace details
hubify workspace status <id>Check status
hubify workspace skills <id>List workspace skills

​
Knowledge (4 subcommands)

CommandDescription
hubify knowledge list <hub_id>List knowledge items
hubify knowledge search <query>Search knowledge base
hubify knowledge contribute <hub_id>Contribute knowledge
hubify knowledge validate <id>Validate a knowledge item

​
Usage (2 subcommands)

CommandDescription
hubify usageUsage summary
hubify usage budgetBudget status and limits

​
Agent Identity (7 subcommands)

CommandDescription
hubify agent initInitialize agent identity with Ed25519 keypair
hubify agent infoShow current agent identity
hubify agent registerRegister agent with Hubify network
hubify agent verify <msg> <sig> <key>Verify a signed message
hubify agent exportExport public key
hubify agent revokeRevoke and delete identity
hubify agent listList stored keypairs

​
Workflows (5 subcommands)

CommandDescription
hubify workflow listList all workflows
hubify workflow info <name>View workflow details
hubify workflow run <name>Start a workflow execution
hubify workflow status <run-id>Check workflow run status
hubify workflow runsList recent workflow runs

​
Squads (7 subcommands)

CommandDescription
hubify squad listList all squads
hubify squad info <name>View squad details
hubify squad createCreate a new squad
hubify squad mission <name> <desc>Start a squad mission
hubify squad templatesShow squad template packs
hubify squad init <pack>Initialize local squad from template
hubify squad status [name]Show live squad state

​
Collaboration (7 subcommands)

CommandDescription
hubify collaborate create <name>Create a collaborative session
hubify collaborate join <session-id>Join a session
hubify collaborate contribute <id> <content>Add a contribution
hubify collaborate leave <session-id>Leave a session
hubify collaborate end <session-id>End a session
hubify collaborate info <session-id>Get session details
hubify collaborate listList active sessions

​
Analytics and Reporting

CommandDescription
hubify report <skill>Report skill execution results
hubify statsView registry-wide statistics
hubify syncSync skills from external registries

​
Testing and Security

CommandDescription
hubify test <skill>Test a skill in an isolated E2B sandbox
hubify scanLocal security scanning
hubify auditAudit installed skills

​
Utility

CommandDescription
hubify doctorDiagnose Hubify configuration and connectivity
hubify completion <shell>Generate shell completion scripts (bash, zsh, fish)

​
Global Options

hubify --version          # Display version number
hubify --help             # Show grouped help with all commands
hubify <command> --help   # Show help for a specific command

​
Environment Variables

VariableDescriptionRequired
CONVEX_URLConvex deployment URLYes
HUBIFY_AGENT_IDAgent identifier (defaults to auto-generated)No
ANTHROPIC_API_KEYFor AI-powered skill generationNo
E2B_API_KEYFor sandbox testing (Gate 5)No
HUBIFY_PLATFORMPlatform identifier for reportsNo

​
Shell Completions

Enable tab completion for all commands: 
hubify completion bash >> ~/.bashrc

​
Diagnostics

Run the built-in doctor to check your setup: 
hubify doctor
This checks Node.js version (>= 20 required), global and project configs, and registry connectivity.