Skip to content
cccskills
FreePublished on GitHub

ck:plans-kanban

View plans dashboard with progress tracking and timeline visualization. Use for kanban boards, plan status overview, phase progress, milestone tracking, project visibility.

The English summary is being prepared. Showing the original description.

See how to install

Files included (14)

  • SKILL.md4.2 KB
  • assets/dashboard-template.html5.3 KB
  • assets/dashboard.css30.4 KB
  • assets/dashboard.js16.8 KB
  • assets/favicon.png1.8 KB
  • package.json328 B
  • scripts/lib/dashboard-renderer.cjs30.2 KB
  • scripts/lib/http-server.cjs9.8 KB
  • scripts/lib/plan-metadata-extractor.cjs14.9 KB
  • scripts/lib/plan-parser.cjs5.7 KB
  • scripts/lib/plan-scanner.cjs7.9 KB
  • scripts/lib/port-finder.cjs1.2 KB
  • scripts/lib/process-mgr.cjs2.7 KB
  • scripts/server.cjs6.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

plans-kanban

Plans dashboard server with progress tracking and timeline visualization.

⚠️ Installation Required

This skill requires npm dependencies. Run one of the following:

# Option 1: Install via Codex Kit CLI (recommended)
ck init  # Runs install.sh which handles all skills

# Option 2: Manual installation
cd .agents/skills/plans-kanban
npm install

Dependencies: gray-matter

Without installation, you'll get Error 500 when viewing plan details.

Purpose

Visual dashboard for viewing plan directories with:

  • Progress tracking per plan
  • Timeline/Gantt visualization
  • Phase status indicators
  • Activity heatmap

Quick Start

# View plans dashboard
node .agents/skills/plans-kanban/scripts/server.cjs \
  --dir ./plans \
  --open

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

# Background mode
node .agents/skills/plans-kanban/scripts/server.cjs \
  --dir ./plans \
  --background

# Stop all running servers
node .agents/skills/plans-kanban/scripts/server.cjs --stop

Skill Command

Use ck:kanban for quick access:

$kanban plans/           # View plans dashboard
$kanban --stop           # Stop kanban server

Features

Dashboard View

  • Plan cards with progress bars
  • Phase status breakdown (completed, in-progress, pending)
  • Last modified timestamps
  • Issue and branch links
  • Priority indicators

Timeline Visualization

  • Gantt-style timeline of plans
  • Duration tracking
  • Activity heatmap

Design

  • Glassmorphism UI with dark mode
  • Responsive grid layout
  • Warm accent colors

CLI Options

OptionDescriptionDefault
--dir <path>Plans directory-
--port <number>Server port3500
--host <addr>Host to bind (0.0.0.0 for remote)localhost
--openAuto-open browserfalse
--backgroundRun in backgroundfalse
--stopStop all servers-

Architecture

scripts/
├── server.cjs               # Main entry point
└── lib/
    ├── port-finder.cjs      # Port allocation (3500-3550)
    ├── process-mgr.cjs      # PID management
    ├── http-server.cjs      # HTTP routing
    ├── plan-parser.cjs      # Plan.md parsing
    ├── plan-scanner.cjs     # Directory scanning
    ├── plan-metadata-extractor.cjs  # Rich metadata
    └── dashboard-renderer.cjs       # HTML generation

assets/
├── dashboard-template.html  # Dashboard HTML template
├── dashboard.css           # Styles
└── dashboard.js            # Client interactivity

HTTP Routes

RouteDescription
/ route or ck:kanban skillDashboard view
ck:kanban?dir=<path>Dashboard for specific directory
/api/plansJSON API for plans data
/api/plans?dir=<path>JSON API for specific directory
/assets/*Static assets
/file/*Local file serving

Remote Access

When using --host 0.0.0.0, the server auto-detects your local network IP:

{
  "success": true,
  "url": "http://localhost:3500/kanban?dir=...",
  "networkUrl": "http://192.168.2.75:3500/kanban?dir=...",
  "port": 3500
}

Use networkUrl to access from other devices on the same network.

Plan Structure

The dashboard scans for directories containing plan.md files:

plans/
├── 251215-feature-a/
│   ├── plan.md              # Required - parsed for phases
│   ├── phase-01-setup.md
│   └── phase-02-impl.md
├── 251214-feature-b/
│   └── plan.md
└── templates/               # Excluded by default

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 to bind all interfaces

PID files: Located at /tmp/plans-kanban-*.pid

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

AI-optimized browser automation CLI with context-efficient snapshots. Use for long autonomous sessions, self-verifying workflows, video recording, and cloud browser testing (Browserbase).

The English summary is being prepared. Showing the original description.

manhvann/codexkit89Updated Aug 29, 2026

Generate images via Nano Banana with 129 curated prompts. Mandatory validation interview refines style/mood/colors (use --skip to bypass). 3 modes: search, creative, wild. Styles: Ukiyo-e, Bento grid, cyberpunk, cinematic, vintage patent.

The English summary is being prepared. Showing the original description.

manhvann/codexkit89Updated Aug 29, 2026

Analyze images/audio/video with Gemini API (better vision than Codex). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

The English summary is being prepared. Showing the original description.

manhvann/codexkit89Updated Aug 29, 2026

ck:ask

Free

Answer technical and architectural questions with expert consultation.

The English summary is being prepared. Showing the original description.

manhvann/codexkit89Updated Aug 29, 2026

Build backends with Node.js, Python, Go (NestJS, FastAPI, Django). Use for REST/GraphQL/gRPC APIs, auth (OAuth, JWT), databases, microservices, security (OWASP), Docker/K8s.

The English summary is being prepared. Showing the original description.

manhvann/codexkit89Updated Aug 29, 2026

Add authentication with Better Auth (TypeScript). Use for email/password, OAuth providers (Google, GitHub), 2FA/MFA, passkeys/WebAuthn, sessions, RBAC, rate limiting.

The English summary is being prepared. Showing the original description.

manhvann/codexkit89Updated Aug 29, 2026

See all skills by manhvann

Report a problem with this skill