# status

Check the status of a migration.

## Usage

```bash
bb2gh status [OPTIONS]
```

## Options

| Option           | Description                |
| ---------------- | -------------------------- |
| `--migration ID` | Migration ID to check      |
| `--list`         | List all migrations        |
| `--watch`        | Continuously update status |

## Examples

```bash
# Check specific migration
bb2gh status --migration mig_abc123

# List all migrations
bb2gh status --list

# Watch migration progress
bb2gh status --migration mig_abc123 --watch
```

## Output

```
Migration: mig_abc123
Started:   2026-01-26 10:30:00
Status:    In Progress

Repositories:
  backend-api       completed    2m 34s
  frontend-web      in_progress  1m 12s (cloning)
  shared-lib        pending
  data-pipeline     pending

Progress: 1/4 completed (25%)
Elapsed:  3m 46s
```

## Migration States

| State         | Description            |
| ------------- | ---------------------- |
| `pending`     | Not started            |
| `in_progress` | Currently migrating    |
| `completed`   | Successfully migrated  |
| `failed`      | Migration failed       |
| `rolled_back` | Reverted after failure |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://n8-group.gitbook.io/bb2gh/commands/status.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.