statusline
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.
Source facts
- Repository
- insightflo/claude-impl-tools
- Last source activity
- March 17, 2026 at 06:04
- Detected SKILL.md language
- English
- Stars
- 17
- Forks
- 3
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
File Explorer
5 filesShowing SKILL.md
SKILL.md
Source instructions · Read-only preview- 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
```bash
./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
1. `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.
2. `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
- [simple-claude-board](https://github.com/insightflo/simple-claude-board) — Full TUI dashboard
- [awesome-claude-plugins](https://github.com/AwesomeJun/awesome-claude-plugins) — Status bar plugins
View on GitHub