CLI Overview
The Hubify CLI gives terminal-first researchers full access to labs, experiments, agents, papers, and compute.
The hubify CLI is a first-class interface to Hubify Labs. Every feature available in the web UI and desktop app is accessible from the terminal. Terminal-only users are not second-class citizens — the CLI is a complete research IDE.
Quick Start
# Install
npm install -g @hubify/cli
# Authenticate
hubify auth login
# Create a lab
hubify lab create --name "my-research" --template blank
# Start the TUI (terminal user interface)
hubify
Architecture
The CLI operates in two modes:
Command Mode
Execute single commands and get results:
hubify experiment run --name "mcmc-test" --pod h100
hubify status
hubify logs EXP-001 --follow
TUI Mode
Launch the full terminal UI — a mirror of the web application:
hubify
The TUI includes:
- Captain View dashboard
- Orchestrator chat panel
- Agent activity feed
- Experiment list with live status
- Log viewer
Command Structure
hubify <command> <subcommand> [options]
| Command | Description |
|---|---|
hubify auth | Authentication (login, logout, token) |
hubify lab | Lab management (create, list, use, delete) |
hubify experiment | Experiment lifecycle (run, status, logs, rerun) |
hubify paper | Paper pipeline (create, draft, review, compile) |
hubify agent | Agent management (add, update, list, metrics) |
hubify task | Task management (list, create, assign, complete) |
hubify pod | GPU pod management (create, list, ssh, stop) |
hubify deploy | Deployment (site deploy, preview, rollback) |
hubify logs | Log viewing (experiment logs, agent logs) |
hubify review | Review workflow (trigger review, view results) |
hubify standup | Standup commands (trigger, list, history) |
hubify site | Lab site management (theme, pages, domain) |
hubify knowledge | Knowledge base (search, get, list, add) |
hubify data | Data management (embed, export, open) |
hubify chat | Chat with the orchestrator directly |
hubify status | Quick status overview |
Global Options
| Option | Description |
|---|---|
--lab <slug> | Target a specific lab (overrides active lab) |
--json | Output as JSON instead of table |
--quiet | Suppress non-essential output |
--verbose | Show detailed output |
--help | Show help for a command |
--version | Show CLI version |
Auto-Launch Sessions
When you run hubify without arguments, it launches four terminal sessions:
- hubify — TUI mirror of the web UI
- claude — Claude Code session synced to the orchestrator
- pi — Multi-agent activity feed
- bash — Standard shell in the lab's working directory
Configuration
# View config
hubify config show
# Set default lab
hubify config set default-lab bigbounce
# Set default GPU
hubify config set default-gpu h100
# Set output format
hubify config set output json
Config is stored at ~/.hubify/config.json.