62 lines
1.7 KiB
Markdown
62 lines
1.7 KiB
Markdown
---
|
|
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
|