Skip to main content

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.

​
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]
OptionDescription
--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]
OptionDescription
--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>
SubcommandDescription
listList 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:
GateBehavior
humanRequires human approval to advance
agentAgents can auto-advance
human+agentEither 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.

​
See also

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.