FABRIC-KANBAN(1)

NAME
fabric-kanban - local orchestration board for coding agents

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

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

--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:
    fabric-kanban

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

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

List tasks for the current workspace:
    fabric-kanban task list

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

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

EXIT STATUS

0   Successful execution.

SEE ALSO
npm(1)