KANBAN(1)

NAME
kanban - local orchestration board for coding agents

SYNOPSIS
kanban [--port number|auto] [--agent id] [--no-open] [command]
kanban task list|create|update|link|unlink|start [options]
kanban hooks ingest|notify|gemini-hook|codex-wrapper [options]
kanban mcp

DESCRIPTION
kanban starts the local Kanban runtime server and serves the web UI. When launched inside a git repository, it opens that repository's indexed workspace. When launched outside git, it starts with no active workspace or falls back to the first indexed project.

OPTIONS

--port <number|auto>
    Bind to a specific local port or pick the first available port starting at 3484.

--agent <id>
    Set the default agent command to one of: claude, codex, gemini, opencode, droid, cline.

--no-open
    Do not open the browser automatically.

--help, -h
    Show help text and exit.

--version, -v
    Show version and exit.

COMMANDS

task|tasks
    Manage Kanban board tasks from the CLI. Subcommands:
    list [--project-path path] [--column backlog|in_progress|review]
    create --prompt text [--project-path path] [--base-ref branch] [--start-in-plan-mode true|false] [--auto-review-enabled true|false] [--auto-review-mode commit|pr|move_to_trash]
    update --task-id id [--prompt text] [--project-path path] [--base-ref branch] [--start-in-plan-mode true|false] [--auto-review-enabled true|false] [--auto-review-mode commit|pr|move_to_trash]
    link --task-id id --linked-task-id id [--project-path path]
    unlink --dependency-id id [--project-path path]
    start --task-id id [--project-path path] All task commands return JSON. Use kebab-case flags only.

hooks
    Runtime hook helpers used by agent adapters. Subcommands:
    ingest [payload] --event to_review|to_in_progress|activity [--source source] [--activity-text text] [--tool-name name] [--final-message text] [--hook-event-name name] [--notification-type type] [--metadata-base64 base64]
    notify same options as ingest, but best-effort.
    gemini-hook
    codex-wrapper --real-binary path [agentArgs...]

mcp Deprecated compatibility command. Prints a deprecation warning and exits.

EXAMPLES

Start server on the default port:
    kanban

Start server without auto-opening a browser:
    kanban --no-open

Start server on a custom port:
    kanban --port 9000

List tasks for the current workspace:
    kanban task list

Create and start a task manually:
    kanban task create --prompt Implement API pagination

Ingest a hook event:
    kanban hooks ingest --event to_review

EXIT STATUS

0   Successful execution.

SEE ALSO
npm(1)