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

# Boards

> Board and pipeline management — create, configure, and manage Kanban-style boards

# Board Commands

The `genie board` command group manages Kanban-style boards with configurable column pipelines. For an overview of how boards, columns, and gates work, see [Boards](/genie/concepts/boards). Boards are project-scoped and replace task types as the primary pipeline mechanism. Each column can have its own gate type and associated action skill.

<Note>
  Boards don't own tasks — projects do. A board defines the **pipeline** (ordered columns + gates) that tasks inside a project flow through. The active board for a repo (set via `genie board use`) determines which pipeline `genie task move` uses.
</Note>

## `genie board create`

Create a new board.

```bash theme={"dark"}
genie board create <name> [options]
```

| Option                 | Description                  |
| ---------------------- | ---------------------------- |
| `--project <project>`  | Project name                 |
| `--from <template>`    | Create from template name    |
| `--columns <columns>`  | Comma-separated column names |
| `--description <text>` | Board description            |

```bash theme={"dark"}
genie board create "Sprint 12" --project my-app --from software
genie board create "Custom Pipeline" --columns "todo,in-progress,review,done"
```

## `genie board list`

List all boards.

```bash theme={"dark"}
genie board list [--project <project>] [--all] [--json]
```

## `genie board show`

Show board detail with column pipeline and task counts.

```bash theme={"dark"}
genie board show <name> [--project <project>] [--json]
```

## `genie board edit`

Edit board or column properties.

```bash theme={"dark"}
genie board edit <name> [options]
```

| Option                 | Description                                      |
| ---------------------- | ------------------------------------------------ |
| `--project <project>`  | Disambiguate by project                          |
| `--column <col>`       | Column name to edit                              |
| `--gate <gate>`        | New gate value (`human`, `agent`, `human+agent`) |
| `--action <action>`    | New action skill                                 |
| `--color <color>`      | New color hex                                    |
| `--rename <new>`       | Rename the column                                |
| `--name <new>`         | Rename the board itself                          |
| `--description <text>` | Update description                               |

```bash theme={"dark"}
genie board edit "Sprint 12" --column review --gate human
genie board edit "Sprint 12" --column build --action "/work"
genie board edit "Sprint 12" --name "Sprint 13"
```

## `genie board delete`

Delete a board.

```bash theme={"dark"}
genie board delete <name> [--project <project>] [--force]
```

<Warning>
  Deleting a board does not delete its tasks, but it does orphan their `column_id` values. If you need to recover the pipeline later, use `genie board archive` instead — archiving keeps the board and its unfinished tasks intact.
</Warning>

## `genie board columns`

Show board column pipeline — displays the ordered list of columns with their gate types and action skills.

```bash theme={"dark"}
genie board columns <name> [--project <project>] [--json]
```

## `genie board use`

Set the active board for the current repo. The active board determines which pipeline is used for `genie task move` operations.

```bash theme={"dark"}
genie board use <name> [--project <project>]
```

## `genie board export`

Export a board as JSON.

```bash theme={"dark"}
genie board export <name> [--project <project>] [--output <file>]
```

## `genie board import`

Import a board from a JSON file.

```bash theme={"dark"}
genie board import --json <file> [--project <project>]
```

## `genie board archive`

Archive a board and its unfinished tasks.

```bash theme={"dark"}
genie board archive <name...> [--project <project>]
```

```bash theme={"dark"}
genie board archive "Sprint 11"
genie board archive "Sprint 11" --project my-app
```

## `genie board reconcile`

Fix orphaned `column_id` values by matching each task's stage name to the board's column names. Useful after renaming columns or switching boards.

```bash theme={"dark"}
genie board reconcile <name> [--project <project>] [--json]
```

## Board Templates

Templates are reusable board blueprints. The built-in `software` template defines the default 7-stage pipeline.

### Templates

`genie template` is the top-level shortcut for board template management. It exposes read-only and deletion operations on the same templates managed by the `genie board template` subcommands below. Use `genie template` for quick inspection; use `genie board template` for authoring (`create`, `edit`, `rename`).

```bash theme={"dark"}
genie template <subcommand>
```

| Subcommand      | Description                                  |
| --------------- | -------------------------------------------- |
| `list`          | List available templates. Supports `--json`. |
| `show <name>`   | Show template details. Supports `--json`.    |
| `delete <name>` | Delete a template.                           |

```bash theme={"dark"}
genie template list
genie template show software
genie template delete my-old-template
```

<Note>
  `genie template` does not include `create`, `edit`, or `rename`. Reach for `genie board template` (documented below) for authoring operations.
</Note>

### `genie board template list`

List all available templates.

```bash theme={"dark"}
genie board template list [--json]
```

### `genie board template show`

Show template detail with pipeline view.

```bash theme={"dark"}
genie board template show <name> [--json]
```

### `genie board template create`

Create a custom board template.

```bash theme={"dark"}
genie board template create <name> [options]
```

### `genie board template edit`

Edit a template column.

```bash theme={"dark"}
genie board template edit <name> [options]
```

### `genie board template rename`

Rename a template.

```bash theme={"dark"}
genie board template rename <old> <new>
```

### `genie board template delete`

Delete a template.

```bash theme={"dark"}
genie board template delete <name>
```

## Column Gates

Each board column can have a gate that controls whether tasks can auto-advance through it:

| Gate          | Behavior                           |
| ------------- | ---------------------------------- |
| `human`       | Requires human approval to advance |
| `agent`       | Agents can auto-advance            |
| `human+agent` | Either can advance                 |

Gates work with the [task lifecycle](/genie/cli/tasks) — when a task is moved to a gated column, the gate determines who can move it out.

<Tip>
  Board state is inspectable from scripts: `genie board show <name> --json` and `genie task list --json` both emit structured output. Combine with `jq` to count tasks per column, flag stalled work, or build custom dashboards.
</Tip>

## See also

<CardGroup cols={2}>
  <Card title="Tasks" icon="list-check" href="/genie/cli/tasks">
    Create, move, and inspect the tasks that flow through board columns.
  </Card>

  <Card title="Projects" icon="folder" href="/genie/cli/projects">
    Projects scope the boards and tasks that belong to a repo.
  </Card>

  <Card title="Boards (concept)" icon="columns-3" href="/genie/concepts/boards">
    How boards, columns, and gates combine into a pipeline.
  </Card>

  <Card title="Releases, Tags & Types" icon="tag" href="/genie/cli/releases-tags-types">
    Tag tasks, group them into releases, or define custom type pipelines.
  </Card>
</CardGroup>