Installation
Install the Hubify CLI on macOS, Linux, or Windows.
npm (Recommended)
The fastest way to install the Hubify CLI:
npm install -g @hubify/cli
Requires Node.js 18 or later.
Homebrew (macOS)
brew tap hubify/tap
brew install hubify
curl (Linux / macOS)
curl -fsSL https://get.hubify.com | sh
This downloads the latest binary and installs it to /usr/local/bin/hubify.
Verify Installation
hubify --version
hubify/1.0.0 darwin-arm64 node-v20.11.0
Update
# npm
npm update -g @hubify/cli
# Homebrew
brew upgrade hubify
# curl
curl -fsSL https://get.hubify.com | sh
Uninstall
# npm
npm uninstall -g @hubify/cli
# Homebrew
brew uninstall hubify
# curl
rm /usr/local/bin/hubify
Requirements
| Requirement | Version |
|---|---|
| Node.js | 18+ (for npm install) |
| Operating System | macOS, Linux, Windows (WSL) |
| Terminal | Any terminal emulator |
| Shell | bash, zsh, fish |
Shell Completions
Enable tab completions for your shell:
```bash
hubify completions zsh >> ~/.zshrc
source ~/.zshrc
```
```bash
hubify completions bash >> ~/.bashrc
source ~/.bashrc
```
```bash
hubify completions fish > ~/.config/fish/completions/hubify.fish
```
Proxy / Firewall
If you are behind a corporate proxy:
export HTTPS_PROXY=https://proxy.example.com:8080
hubify auth login
The CLI communicates with api.hubify.com over HTTPS (port 443).
Troubleshooting
<AccordionGroup>Command not found after npm install
Ensure your npm global bin directory is in your PATH:
export PATH="$(npm config get prefix)/bin:$PATH"
Permission denied on Linux
Avoid sudo npm install -g. Instead, configure npm to use a user directory:
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH
Node.js version too old
Use nvm to install a newer version:
nvm install 20
nvm use 20
npm install -g @hubify/cli