---
name: ck-kanban
description: Launch a kanban dashboard for plans directory with progress tracking and Gantt timeline visualization. Use for viewing plan status, phase progress, milestone tracking, and project visibility.
---

# Kanban — Plans Dashboard

Launches a visual kanban dashboard for a plans directory with progress tracking and timeline.

## When to Use

- Viewing progress across multiple implementation plans
- Tracking phase statuses visually (completed, in-progress, pending)
- Sharing a local project dashboard on the network

## Don't Use When

- Plans directory doesn't exist or has no `plan.md` files
- Only need to read a single plan (read the file directly)

## Usage

```
ck-kanban              # View dashboard for ./plans
ck-kanban plans/       # View dashboard for specific directory
ck-kanban --stop       # Stop running server
```

## Execution

**Stop server** (if `--stop` flag provided):
```bash
node $HOME/.claude/skills/plans-kanban/scripts/server.cjs --stop
```

**Start server** (run as background task with 5-minute timeout):
```bash
node $HOME/.claude/skills/plans-kanban/scripts/server.cjs \
  --dir "$PLANS_DIR" \
  --host 0.0.0.0 \
  --open \
  --foreground
```

Run in background mode with a 300000ms timeout to keep the process alive.

## After Starting

Parse the JSON output and report to user:
- Local URL (e.g., `http://localhost:3500/kanban?dir=...`)
- Network URL for remote device access (e.g., `http://192.168.x.x:3500/kanban?dir=...`)

**Always display the FULL URL including path and query string — never truncate to just `host:port`.**

## Features

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