---
name: ck-plans-kanban
description: View plans dashboard with progress tracking and Gantt timeline. Use for kanban boards, plan status overview, phase progress visualization, and milestone tracking across plan directories.
---

# Plans Kanban Dashboard

Visual dashboard for plan directories with progress tracking, Gantt timeline, and activity heatmap.

## When to Use

- Viewing progress across multiple implementation plans
- Tracking phase statuses (completed, in-progress, pending)
- Visualizing plan timelines and activity
- Monitoring milestone completion

## Don't Use When

- Managing individual tasks within a single file (edit the plan.md directly)
- Real-time agent orchestration (not yet supported)

## Installation Required

```bash
cd $HOME/.claude/skills/plans-kanban
npm install  # installs gray-matter dependency
```

## Usage

```bash
# Start dashboard for ./plans directory
node $HOME/.claude/skills/plans-kanban/scripts/server.cjs --dir ./plans --open

# Remote access (all interfaces)
node $HOME/.claude/skills/plans-kanban/scripts/server.cjs --dir ./plans --host 0.0.0.0 --open

# Background mode
node $HOME/.claude/skills/plans-kanban/scripts/server.cjs --dir ./plans --background

# Stop all running servers
node $HOME/.claude/skills/plans-kanban/scripts/server.cjs --stop
```

## CLI Options

| Option | Description | Default |
|--------|-------------|---------|
| `--dir <path>` | Plans directory | required |
| `--port <n>` | Server port | 3500 |
| `--host <addr>` | Host to bind | localhost |
| `--open` | Auto-open browser | false |
| `--background` | Run in background | false |
| `--stop` | Stop all servers | - |

## Plan Structure Required

Plans directory must contain subdirectories with `plan.md` files:

```
plans/
├── 251215-feature-a/
│   ├── plan.md          # Required - parsed for phases
│   └── phase-01-setup.md
└── 251214-feature-b/
    └── plan.md
```

## HTTP Routes

| Route | Description |
|-------|-------------|
| `/` or `/kanban` | Dashboard view |
| `/api/plans` | JSON API for plans data |

## Features

- Plan cards with progress bars
- Phase status breakdown
- Gantt-style timeline
- Activity heatmap
- Issue and branch links

## Troubleshooting

- **Port in use:** Server auto-increments from 3500-3550
- **No plans found:** Ensure directories contain `plan.md` files
- **Remote access denied:** Use `--host 0.0.0.0`
- **Error 500:** Run `npm install` in skill directory first