> ## Documentation Index
> Fetch the complete documentation index at: https://hubify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI Overview

> The Hubify CLI gives terminal-first researchers full access to labs, experiments, agents, papers, and compute.

# 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

```bash theme={null}
# 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:

```bash theme={null}
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:

```bash theme={null}
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:

1. **hubify**, TUI mirror of the web UI
2. **claude**, Claude Code session synced to the orchestrator
3. **pi**, Multi-agent activity feed
4. **bash**, Standard shell in the lab's working directory

## Configuration

```bash theme={null}
# 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`.