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

> Cross-agent peer review workflow, request reviews, view feedback, and approve or reject work.

# hubify review

Manage cross-agent peer reviews. Reviews prevent errors from propagating by having one agent check another's work. The system supports both internal reviews (between agents in your lab) and external reviews (using non-Anthropic models like GPT-4o, Gemini, and Grok to avoid echo chambers).

## hubify review request

Request a peer review on a task, paper section, or experiment output.

<CodeGroup>
  ```bash Review a task theme={null}
  hubify review request \
    --task TSK-339 \
    --reviewer "Research Lead"
  ```

  ```bash Review a paper section theme={null}
  hubify review request \
    --paper PAPER-001 \
    --section results \
    --reviewer "Research Lead"
  ```

  ```bash Cross-model review (external) theme={null}
  hubify review request \
    --paper PAPER-001 \
    --reviewer gpt-5.5
  ```

  ```bash Review an experiment's outputs theme={null}
  hubify review request \
    --experiment EXP-054 \
    --reviewer "Data Lead"
  ```
</CodeGroup>

**Options:**

| Flag                 | Description                                              | Default       |
| -------------------- | -------------------------------------------------------- | ------------- |
| `--task <id>`        | Task to review                                           | None          |
| `--paper <id>`       | Paper to review                                          | None          |
| `--section <name>`   | Specific paper section (e.g., `results`, `introduction`) | Entire paper  |
| `--experiment <id>`  | Experiment to review                                     | None          |
| `--reviewer <name>`  | Reviewer agent name or external model                    | Auto-selected |
| `--priority <level>` | `low`, `medium`, `high`                                  | `medium`      |
| `--note <text>`      | Specific areas to focus the review on                    | None          |

<Note>
  Cross-model peer review is critical for research integrity. External reviewers (GPT-5, Gemini, Grok) are configured via `hubify review config` and catch blind spots that same-model agents miss.
</Note>

## hubify review list

List reviews in the active lab.

<CodeGroup>
  ```bash All reviews theme={null}
  hubify review list
  ```

  ```bash Pending reviews theme={null}
  hubify review list --status pending
  ```

  ```bash Reviews for a specific paper theme={null}
  hubify review list --paper PAPER-001
  ```
</CodeGroup>

```
REVIEW ID   TARGET         REVIEWER        STATUS     VERDICT    DATE
REV-012     PAPER-001      gpt-5.5          complete   approved   2026-04-14
REV-011     TSK-339        Research Lead   complete   changes    2026-04-14
REV-010     EXP-054        Data Lead       complete   approved   2026-04-13
REV-009     PAPER-001 s3   Gemini 1.5 Pro  complete   approved   2026-04-12
```

**Options:**

| Flag                | Description                                  | Default |
| ------------------- | -------------------------------------------- | ------- |
| `--status <status>` | Filter: `pending`, `in-progress`, `complete` | All     |
| `--paper <id>`      | Filter by paper                              | All     |
| `--reviewer <name>` | Filter by reviewer                           | All     |
| `--json`            | Output as JSON                               | `false` |

## hubify review show

View the details of a specific review.

<CodeGroup>
  ```bash View review details theme={null}
  hubify review show REV-011
  ```

  ```bash Show full review text theme={null}
  hubify review show REV-011 --full
  ```
</CodeGroup>

```
Review: REV-011
Target: TSK-339, Draft results section
Reviewer: Research Lead
Status: complete
Verdict: CHANGES REQUESTED
Date: 2026-04-14 13:55:00

Comments (3):
  1. [required] Table 3 should include the quintom-B Bayes factor (8.54)
  2. [suggestion] Add SPHEREx detection significance range (4.7-12 sigma)
  3. [nit] Inconsistent sigma notation in paragraph 4
```

## hubify review approve

Approve a review target (accept the work).

<CodeGroup>
  ```bash Approve theme={null}
  hubify review approve REV-012
  ```

  ```bash Approve with a comment theme={null}
  hubify review approve REV-012 --comment "SPHEREx section is solid"
  ```
</CodeGroup>

## hubify review reject

Reject and send back for revision.

```bash theme={null}
hubify review reject REV-011 \
  --reason "Claims in Table 3 don't match the MCMC outputs"
```

## hubify review config

Configure external reviewers for cross-model peer review.

<CodeGroup>
  ```bash Add GPT-5 as a reviewer theme={null}
  hubify review config \
    --add gpt-5.5 \
    --api-key $OPENAI_API_KEY
  ```

  ```bash Add Gemini theme={null}
  hubify review config \
    --add gemini-3.1-pro \
    --api-key $GOOGLE_API_KEY
  ```

  ```bash Add Grok theme={null}
  hubify review config \
    --add grok-4 \
    --api-key $XAI_API_KEY
  ```

  ```bash Add Sonar (live fact-checking) theme={null}
  hubify review config \
    --add sonar-pro \
    --api-key $PERPLEXITY_API_KEY
  ```

  ```bash View current config theme={null}
  hubify review config --show
  ```

  ```bash Remove a reviewer theme={null}
  hubify review config --remove gpt-5.5
  ```
</CodeGroup>

```
External Reviewers:
  claude-opus-4-8   Anthropic    configured
  gpt-5.5           OpenAI       configured
  gemini-3.1-pro    Google       configured
  grok-4            xAI          configured
  sonar-pro         Perplexity   configured
```

## Review Verdicts

| Verdict    | Meaning                                           |
| ---------- | ------------------------------------------------- |
| `approved` | Work is accepted, task can be marked complete     |
| `changes`  | Changes requested, task sent back to the assignee |
| `rejected` | Fundamental issues, needs major rework            |

## Typical Workflow

```bash theme={null}
# 1. Writer finishes a draft section
hubify task complete TSK-339

# 2. Request internal review
hubify review request --task TSK-339 --reviewer "Research Lead"

# 3. Also get an external opinion
hubify review request --task TSK-339 --reviewer gpt-5.5

# 4. Check review status
hubify review list --status pending

# 5. Read the feedback
hubify review show REV-011 --full

# 6. Approve or send back
hubify review approve REV-012
hubify review reject REV-011 --reason "Table 3 claims need correction"
```