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

# graft list

> List all branches with size and integrity status.

# `graft list`

Display all branches with their size, commit count, integrity status, and last update time.

## Usage

```bash theme={null}
graft list
```

## Output

```text theme={null}
Container: my-postgres
Project root: ~/.graft/my-postgres

BRANCH      ACTIVE  SIZE    COMMITS  INTEG   UPDATED
experiment  *       289.2M  0        ⟳      2026-06-04T12:00:00Z
main                289.2M  1        ✓      2026-06-04T11:59:00Z
```

## Columns

| Column    | Description                                                 |
| --------- | ----------------------------------------------------------- |
| `BRANCH`  | Branch name                                                 |
| `ACTIVE`  | `*` marks the currently active branch                       |
| `SIZE`    | Total file size on disk                                     |
| `COMMITS` | Number of commits in the DAG for this branch                |
| `INTEG`   | Integrity status: `✓` verified, `⟳` pending, `-` no commits |
| `UPDATED` | Last update timestamp                                       |

## Integrity Status

| Icon | Meaning                                                                         |
| ---- | ------------------------------------------------------------------------------- |
| `✓`  | The latest commit's Merkle root matches the current files                       |
| `⟳`  | Commit exists but hasn't been verified yet (hashing in progress or not yet run) |
| `-`  | No commits on this branch                                                       |

## Exit Codes

| Code | Meaning                                   |
| ---- | ----------------------------------------- |
| `0`  | List printed successfully                 |
| `1`  | Error (not initialized, state file issue) |