| name | statusline |
| description | Displays TASKS.md progress in real time on Line 3 of the Claude Code status bar. Use this whenever you want a live view of project progress or need task tracking at a glance. Guides "show progress", "set up statusline", or "task status" requests. Triggered by /statusline. |
| version | 1.1.0 |
Statusline — TASKS.md Progress
Displays project task progress in real time on the Claude Code status bar.
📋 12/34 ▓▓▓░░░░░░░ Phase 2 → T2.1: Build API
Installation
./skills/statusline/install.sh
Or installed automatically at Step 5 of the root install.sh.
Displayed Information
| Field | Description |
|---|
📋 12/34 | Completed / total task count |
▓▓▓░░░░░░░ | Progress bar (10 segments) |
Phase 2 | Currently active phase |
→ T2.1: ... | Next incomplete task |
How It Works
statusline-segment.sh — Parses TASKS.md on each status bar refresh (30-second cache). Installed globally (~/.claude/) since it auto-detects the current project's TASKS.md.hooks/tasks-status-writer.js — Immediately invalidates the cache whenever TASKS.md is edited. Installed per-project (.claude/hooks/) since it should only activate in projects that have TASKS.md.
File Structure
skills/statusline/
├── SKILL.md
├── install.sh # Installation script
├── statusline-segment.sh # Status bar Line 3 output
└── hooks/
└── tasks-status-writer.js # PostToolUse hook
Related
