| 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
