> ## 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.

# hubify agent

> Agent management commands, add, configure, monitor, and manage your multi-agent research team.

# hubify agent

Manage the multi-agent team in your lab. Agents are organized in a hierarchy: orchestrator, leads, and workers.

## Commands

### `hubify agent list`

List all agents in the active lab:

```bash theme={null}
hubify agent list
```

```
AGENT             ROLE      MODEL         STATUS   TASKS   QC RATE
Orchestrator      orch      claude-opus   active   342     N/A
Research Lead     lead      claude-opus   active   128     94%
Paper Lead        lead      claude-opus   active   87      97%
Analysis Worker   worker    claude-sonnet active   203     91%
Figure Worker     worker    claude-haiku  active   156     88%
Data Worker       worker    claude-haiku  active   189     95%
```

Show the agent hierarchy as a tree:

```bash theme={null}
hubify agent list --tree
```

```
Orchestrator (claude-opus)
├── Research Lead (claude-opus)
│   ├── Analysis Worker (claude-sonnet)
│   └── Data Worker (claude-haiku)
└── Paper Lead (claude-opus)
    └── Figure Worker (claude-haiku)
```

### `hubify agent add`

Add a new agent:

```bash theme={null}
hubify agent add \
  --role lead \
  --name "Cosmology Lead" \
  --model claude-opus \
  --specialty "MCMC analysis, CMB power spectra, bounce cosmology"
```

| Option        | Required | Description                                                                                                                                                       |
| ------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--role`      | Yes      | `lead` or `worker`                                                                                                                                                |
| `--name`      | Yes      | Descriptive name                                                                                                                                                  |
| `--model`     | Yes      | AI model (`claude-opus-4-8`, `claude-opus-4-8`, `claude-sonnet-5`, `claude-haiku-4-5`, `gpt-5.5`, `gpt-5.5-mini`, `gemini-3.1-pro`, `gemini-3.1-flash`, `grok-4`) |
| `--specialty` | No       | Free-text description of the agent's expertise                                                                                                                    |
| `--parent`    | No       | Parent agent name (defaults to Orchestrator)                                                                                                                      |

### `hubify agent update`

Update an agent's configuration:

```bash theme={null}
# Change model
hubify agent update "Analysis Worker" --model claude-sonnet

# Update specialty
hubify agent update "Research Lead" --specialty "Galaxy surveys, anomaly detection"

# Disable temporarily
hubify agent update "Figure Worker" --status inactive
```

### `hubify agent remove`

Remove an agent from the team:

```bash theme={null}
hubify agent remove "Data Worker"
```

Pending tasks assigned to the removed agent are reassigned by the orchestrator.

### `hubify agent metrics`

View performance metrics for an agent:

```bash theme={null}
hubify agent metrics "Research Lead"
```

```
Agent: Research Lead
Model: claude-opus
Tasks completed:    128
QC pass rate:       94%
Avg task duration:  12m
Tokens used (30d):  2.4M
Cost (30d):         $18.40
Active since:       2026-03-15
```

### `hubify agent review-config`

Configure cross-model peer review:

```bash theme={null}
# Add a reviewer
hubify agent review-config --add-reviewer gpt-5.5 --api-key $OPENAI_API_KEY

# Show current config
hubify agent review-config --show

# Remove a reviewer
hubify agent review-config --remove-reviewer grok-4
```

### `hubify agent logs`

View recent activity for an agent:

```bash theme={null}
hubify agent logs "Research Lead" --limit 20
```

## Examples

```bash theme={null}
# Add a specialized worker for a new research branch
hubify agent add --role worker --name "PTA Worker" --model claude-sonnet \
  --specialty "Pulsar timing arrays, gravitational wave backgrounds"

# Check which agent is most productive
hubify agent list --json | jq 'sort_by(.tasks) | reverse | .[0]'

# Rotate models for cost optimization
hubify agent update "Data Worker" --model claude-haiku
```