Fabric Kanban — Multi-Agent Orchestration Board (Research Preview)

[!WARNING] Fabric Kanban is a research preview and uses experimental features of CLI agents like bypassing permissions and runtime hooks for more autonomy.

Install

# Run once (no install)
npx @fabriccode/kanban

# Or install globally
npm i -g @fabriccode/kanban

# Launch
fabric-kanban

Update

# Built-in updater (recommended)
fabric-kanban --update

# Or via npm
npm update -g @fabriccode/kanban

Features

| Feature | Description | |---------|-------------| | Parallel Agents | Each task card runs in its own worktree with isolated terminal | | Auto-Commit/PR | Enable autonomous mode — agents commit or open PRs on completion | | Dependency Chains | Link tasks so one completing triggers the next | | Visual Diff Review | See changes per task, leave comments, send back to agent | | Git Integration | Full git UI: history, branches, fetch, pull, push | | Multi-Agent Support | Claude, Codex, Gemini, OpenCode, Droid |

Usage

1. Open Fabric Kanban

# Run directly (no install required)
npx @fabriccode/kanban

# Or install globally and launch
npm i -g @fabriccode/kanban
fabric-kanban

# Update to latest
fabric-kanban --update

Run this from the root of any git repo. Fabric Kanban will detect your installed CLI agent and launch a local running webserver in your browser. No account or setup required, it works right out of the box.

2. Create Tasks

Create a task card manually, or open the sidebar chat and ask your agent to break work down into tasks for you. Fabric Kanban injects board-management instructions into that session so you can simply ask it to add tasks, link tasks, or start work on your board.

3. Link and Automate

⌘ + click a card to link it to another task. When a card is completed and moved to trash, linked tasks auto-start. Combine with auto-commit for fully autonomous dependency chains: one task completes → commits → kicks off the next → repeat. It's a pretty magical experience asking your agent to decompose a big task into subtasks that auto-commit — it'll cleverly do it in a way that parallelizes for maximum efficiency and links tasks together for end-to-end autonomy.

4. Start Tasks

Hit the play button on a card. Fabric Kanban creates an ephemeral worktree just for that task so agents work in parallel without merge conflicts. Under the hood, it also symlinks gitignored files like node_modules so you don't have to worry about slow npm installs for each copy of your project.

[!NOTE] Symlinks (symbolic links) are special "shortcuts" pointing to another file or directory, allowing access to the target from a new location without duplicating data. They work great in this case since you typically don't modify gitignored files in day-to-day work, but for when you do then don't use Fabric Kanban.

As agents work, Fabric Kanban uses hooks to display the latest message or tool call on each card, so you can monitor hundreds of agents at a glance without opening each one.

5. Review Changes

Click a card to view the agent's TUI and a diff of all the changes in that worktree. Fabric Kanban includes its own checkpointing system so you can also see a diff from the last messages you've sent. Click on lines to leave comments and send them back to the agent.

To easily test and debug your app, create a Script Shortcut in settings. Use a command like npm run dev so that all you have to do is hit a play button in the navbar instead of remembering commands or asking your agent to do it.

6. Ship It

When the work looks good, hit Commit or Open PR. Fabric Kanban sends a dynamic prompt to the agent to convert the worktree into a commit on your base ref or a new PR branch, and work through any merge conflicts intelligently. Or skip review by enabling auto-commit / auto-PR and the agent ships as soon as it's done. Move the card to trash to clean up the worktree (you can always resume later since Fabric Kanban tracks the resume ID).

7. Keep Track with Git Interface

Click the branch name in the navbar to open a full git interface to browse commit history, switch branches, fetch, pull, push, and visualize your git all without leaving Fabric Kanban. Keep track of everything your agents are doing across branches as work is completed.

Configuration

Data is stored in ~/.fabric-kanban/:

~/.fabric-kanban/
├── kanban/           # Global config
├── worktrees/        # Task worktrees
└── data/             # Session data

Project-specific config: <project>/.fabric-kanban/kanban/config.json

Architecture

Fabric Kanban is built on:

• Runtime: Node.js + Express + tRPC
• UI: React + Tailwind CSS + Radix UI
• Terminal: node-pty + xterm.js
• Agent SDK: @clinebot/* for native agent sessions

Agent Support

| Agent | Status | Detection | |-------|--------|-----------| | Claude (Claude Code) | ✅ | claude on PATH | | Codex (OpenAI) | ✅ | codex on PATH | | Gemini CLI | ✅ | gemini on PATH | | OpenCode | ✅ | opencode on PATH | | Droid | ✅ | droid on PATH |

Local Development

Clone the repo and install dependencies:

git clone https://github.com/Fabric-Pro/fabric-kanban.git
cd fabric-kanban
npm run install:all

Run full stack (recommended)

npm run dev:full

This starts both the runtime server and the Vite web UI together, auto-selects free ports, and opens your browser automatically. Any change to web-ui/src/ hot-reloads instantly. Hit Ctrl+C to stop both.

Run separately (two terminals)

# Terminal 1 — runtime server (port 3484)
npm run dev

# Terminal 2 — web UI with HMR (port 4173)
npm run web:dev

Build & verify

npm run build    # Build dist/
npm run check    # Lint + typecheck + tests

Publishing

# 1. Bump version
npm version patch   # or minor / major

# 2. Build and publish (prepublishOnly runs build + check automatically)
npm publish

The prepublishOnly hook runs npm run build && npm run check before every publish, so tests must pass and the build must succeed before the package reaches the registry.

Published as @fabriccode/kanban on the public npm registry.

Telemetry

Fabric Kanban uses telemetry to improve the product:

• Errors and crashes (via Sentry)
• Usage patterns (via PostHog)

No source code or sensitive data is collected.

License

Apache 2.0 © 2026 Fabric

Related

• Fabric — Core platform
• Weave — Plugin framework
• Fabric Agents — Desktop agent app