Installation

Hubify can be installed globally or used directly via npx without installation.

Requirements

• Node.js 20 or later
• npm, bun, pnpm, or yarn

Check your Node version:

node --version
# Should output v20.x.x or higher

Global Installation

Install Hubify globally to use it from anywhere:

npm install -g hubify

bun add -g hubify

pnpm add -g hubify

yarn global add hubify

Verify installation:

hubify --version
# hubify/0.3.2

Using npx (No Installation)

Run Hubify directly without installing:

npx hubify --help
npx hubify search "react patterns"
npx hubify install typescript-best-practices

Using bunx

If you prefer Bun's package runner:

bunx hubify --help
bunx hubify search "api design"

Project-Local Installation

Install Hubify as a dev dependency in your project:

npm install --save-dev hubify

Then use it via npx or add to your package.json scripts:

{
  "scripts": {
    "hubify": "hubify",
    "skill:search": "hubify search",
    "skill:install": "hubify install"
  }
}

Shell Completions

Enable tab completion for faster CLI usage:

hubify completion bash >> ~/.bashrc
source ~/.bashrc

hubify completion zsh >> ~/.zshrc
source ~/.zshrc

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

Configuration

Global Configuration

Create a global configuration at ~/.hubify/config.yaml:

# ~/.hubify/config.yaml
registry:
  url: https://api.hubify.com

defaults:
  min_confidence: 0.7
  auto_update: true

agent:
  id: my-agent-id
  platform: claude-code

Project Configuration

Initialize Hubify in your project to create local config:

hubify init

This creates .hubify/config.yaml in your project root:

# .hubify/config.yaml
project:
  name: my-project

skills:
  install_path: .hubify/skills

defaults:
  platform: cursor

Verify Setup

Run the doctor command to verify your installation:

hubify doctor

  Hubify Doctor
  Checking your setup...

  [PASS] Node.js version      v22.0.0 (>= 20 required)
  [PASS] Global config        /Users/you/.hubify/config.yaml
  [PASS] Project config       /path/to/project/.hubify/config.yaml
  [PASS] Registry connection  Connected to Hubify registry

  All checks passed! Hubify is ready to use.

Troubleshooting

Command Not Found

If hubify is not found after global installation:

# Check npm global bin directory
npm config get prefix

# Add to PATH if needed (bash/zsh)
export PATH="$(npm config get prefix)/bin:$PATH"

Permission Errors

If you get permission errors during global install:

# Option 1: Use sudo (not recommended)
sudo npm install -g hubify

# Option 2: Fix npm permissions (recommended)
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

Connection Issues

If you can't connect to the registry:

# Check connectivity
hubify doctor

# Verify API endpoint
curl https://api.hubify.com/health

Updating

Update to the latest version:

npm update -g hubify

bun update -g hubify

pnpm update -g hubify

Uninstalling

Remove Hubify:

npm uninstall -g hubify

bun remove -g hubify

pnpm remove -g hubify

To also remove configuration:

rm -rf ~/.hubify