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

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.

`genie board create`

Create a new board.

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

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.

genie board list [--project <project>] [--all] [--json]

`genie board show`

Show board detail with column pipeline and task counts.

genie board show <name> [--project <project>] [--json]

`genie board edit`

Edit board or column properties.

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

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.

genie board delete <name> [--project <project>] [--force]

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.

`genie board columns`

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

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.

genie board use <name> [--project <project>]

`genie board export`

Export a board as JSON.

genie board export <name> [--project <project>] [--output <file>]

`genie board import`

Import a board from a JSON file.

genie board import --json <file> [--project <project>]

`genie board archive`

Archive a board and its unfinished tasks.

genie board archive <name...> [--project <project>]

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.

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

genie template <subcommand>

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

genie template list
genie template show software
genie template delete my-old-template

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

`genie board template list`

List all available templates.

genie board template list [--json]

`genie board template show`

Show template detail with pipeline view.

genie board template show <name> [--json]

`genie board template create`

Create a custom board template.

genie board template create <name> [options]

`genie board template edit`

Edit a template column.

genie board template edit <name> [options]

`genie board template rename`

Rename a template.

genie board template rename <old> <new>

`genie board template delete`

Delete a template.

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 — when a task is moved to a gated column, the gate determines who can move it out.

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.

Tasks

Create, move, and inspect the tasks that flow through board columns.

Projects

Projects scope the boards and tasks that belong to a repo.

Boards (concept)

How boards, columns, and gates combine into a pipeline.

Releases, Tags & Types

Tag tasks, group them into releases, or define custom type pipelines.

Getting Started

Core Concepts

The Genie Loop

Power Skills

CLI Reference

Configuration

Security & Trust

Architecture

Observability

Hacks & Tips

Contributing

Boards

Board Commands

`genie board create`

`genie board list`

`genie board show`

`genie board edit`

`genie board delete`

`genie board columns`

`genie board use`

`genie board export`

`genie board import`

`genie board archive`

`genie board reconcile`

Board Templates

Templates

`genie board template list`

`genie board template show`

`genie board template create`

`genie board template edit`

`genie board template rename`

`genie board template delete`

Column Gates

See also

Tasks

Projects

Boards (concept)

Releases, Tags & Types

​Board Commands

​genie board create

​genie board list

​genie board show

​genie board edit

​genie board delete

​genie board columns

​genie board use

​genie board export

​genie board import

​genie board archive

​genie board reconcile

​Board Templates

​Templates

​genie board template list

​genie board template show

​genie board template create

​genie board template edit

​genie board template rename

​genie board template delete

​Column Gates

​See also

Tasks

Projects

Boards (concept)

Releases, Tags & Types

Board Commands

`genie board create`

`genie board list`

`genie board show`

`genie board edit`

`genie board delete`

`genie board columns`

`genie board use`

`genie board export`

`genie board import`

`genie board archive`

`genie board reconcile`

Board Templates

Templates

`genie board template list`

`genie board template show`

`genie board template create`

`genie board template edit`

`genie board template rename`

`genie board template delete`

Column Gates

See also