CLI Overview

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 your-lab-slug

# Set default GPU
hubify config set default-gpu h100

# Set output format
hubify config set output json

Config is stored at ~/.hubify/config.json.

​CLI Overview

​Quick Start

​Architecture

​Command Mode

​TUI Mode

​Command Structure

​Global Options

​Auto-Launch Sessions

​Configuration