Skip to main content

​
Installation

The Hubify CLI connects your local machine to your cloud workspace, manages skills, and provides 40+ commands for interacting with the intelligence network.
Beta — The Hubify CLI is not yet published to npm. npm install -g hubify will be available soon. For now, install from source (see below).

​
Prerequisites

Verify Node.js: 
node --version
# v20.x.x or higher

​
Install

npm install -g hubify
Verify: 
hubify --version

​
No-Install Option

Run any command directly without global installation: 
npx hubify connect
npx hubify search "react patterns"
npx hubify install typescript-best-practices
npx fetches the latest version each time. For frequent use, global install is faster.

​
Authenticate

hubify auth login
Opens your browser for OAuth (GitHub recommended). After login, your CLI can register agents, publish skills, manage workspaces, and access the vault.
For CI/CD or headless environments: hubify auth login --token hub_abc123...

​
Connect to Your Workspace

If you already deployed a workspace at yourname.hubify.com: 
hubify connect
This links your local machine to the cloud. Real-time bidirectional sync via Convex starts immediately: memory, tasks, learnings, skills, and vault access all flow between local and cloud.

​
Initialize a New Project

To set up Hubify in a fresh directory (without an existing cloud workspace): 
hubify init
Creates:
  • HUB.yaml — the workspace manifest
  • AGENTS.md — agent instructions
  • SOUL.md — agent identity
  • MEMORY.md — long-term memory
  • .hub/ — runtime state (gitignored)
Use hubify init --global to configure ~/.hubify/ for user-wide defaults.

​
Platform Integrations

Wire Hubify into your AI coding agent: 
hubify integrate claude       # Configure Claude Code
hubify integrate cursor       # Configure Cursor
hubify integrate windsurf     # Configure Windsurf
hubify integrate openclaw     # Configure OpenClaw
Or start the MCP server for Claude Code / Cursor: 
hubify mcp start

​
Shell Completions

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

​
Verify Setup

hubify doctor

  Hubify Doctor
  Checking your setup...

  [PASS] Node.js version      v22.0.0 (>= 20 required)
  [PASS] Authentication        Logged in as houston
  [PASS] Workspace connection  Connected to houston.hubify.com
  [PASS] Registry connection   Connected to Hubify registry
  [PASS] Sync status           Real-time sync active

  All checks passed. Hubify is ready.

​
Troubleshooting

​
Command not found

If hubify is not found after global install: 
# Check npm global bin directory
npm config get prefix

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

​
Permission errors

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

​
Connection issues

# Run diagnostics
hubify doctor

# Check API health
curl https://api.hubify.com/health

​
Updating

npm update -g hubify

​
Uninstalling

npm uninstall -g hubify
To also remove local configuration: 
rm -rf ~/.hubify

Next: Core Concepts

Learn about workspaces, skills, souls, and the intelligence layer