| name | vibe-progress |
| description | Displays a live ASCII progress dashboard for the current vibe project. Triggers on "/vibe-progress", "progress:", "show progress", "how far along are we". Reads vibe/TASKS.md and git log to render a clean dashboard. Shows overall progress, phase gate status, active work, completed features, active bugs, backlog items, scope decisions, and last git activity. No files are modified. Read-only. Always runs in Plan Mode.
|
Vibe Progress Skill
Renders a live ASCII dashboard of the current project's build progress.
Reads vibe/TASKS.md and git history. Never modifies any file.
Always run in Plan Mode. Read-only.
Step 1 — Read project state
vibe/TASKS.md — phases, features, tasks, gates, active work, backloggit log --oneline -1 — last commitgit log --oneline --since="7 days ago" | wc -l — commits this weekvibe/bugs/ — count folders, note any activevibe/backlog/ — count files (deferred items)vibe/DECISIONS.md — count D-[ID] entriesvibe/cost/history.json — total project cost if exists (read silently, skip if missing)vibe/.doctor-last-run — timestamp of last doctor: run (skip if missing)
Step 2 — Calculate stats
Phase 1:
- Total tasks: count P1-XXX items
- Done: count [x] P1-XXX items
- Status: ✅ / 🔄 / ⬜
Phase 2:
- Total features: count feature blocks
- Done: count ✅ features
- Active: 🔄 feature name + task progress (N/total)
- Active tasks: list [ ] and [x] tasks in active block
Phase 3:
- Total tasks, done tasks
- Status: ✅ / 🔄 / ⬜
Overall:
- Total tasks across all phases, done tasks
- Overall % = (done / total) × 100, rounded to nearest 5
Phase gates:
Read ## Phase gates section from TASKS.md exactly.
Extract each gate line with its emoji status.
Backlog:
Count items in vibe/backlog/ folder.
List names if ≤3 items; show count only if >3.
Cost (if vibe/cost/history.json exists):
node -e "
const h = require('./vibe/cost/history.json');
const total = h.sessions ? h.sessions.reduce((s,x) => s + (x.cost_usd||0), 0) : 0;
const sessions = h.sessions ? h.sessions.length : 0;
console.log('COST:$' + total.toFixed(2) + ':' + sessions + ' sessions');
" 2>/dev/null || echo "COST:none"
If no history.json — show "not tracked" in dashboard.
Env health (if vibe/.doctor-last-run exists):
if [ -f "vibe/.doctor-last-run" ]; then
last=$(cat vibe/.doctor-last-run)
now=$(date +%s)
age=$(( (now - last) / 3600 ))
if [ $age -lt 1 ]; then echo "ENV:healthy:checked this session"
elif [ $age -lt 24 ]; then echo "ENV:stale:checked ${age}h ago"
else echo "ENV:unknown:run doctor: to check"
fi
else
echo "ENV:unknown:doctor: not yet run"
fi
Step 3 — Render the dashboard
┌─────────────────────────────────────────────────────────────┐
│ [PROJECT NAME] — Build Progress │
│ [overall%] complete · [N] tasks done of [total] │
├─────────────────────────────────────────────────────────────┤
│ PHASES │
│ │
│ Phase 1 [bar] [N/total] [status] │
│ Phase 2 [bar] [N/total] [status] │
│ Phase 3 [bar] [N/total] [status] │
├─────────────────────────────────────────────────────────────┤
│ PHASE GATES │
│ │
│ Phase 1 → 2: [✅ reviewed [date] / 🔴 BLOCKED / ⬜ pending] │
│ Phase 2 → 3: [status] │
│ Phase N → deploy: [status] │
├─────────────────────────────────────────────────────────────┤
│ ACTIVE NOW │
│ [Feature name or Phase 3 task] │
│ │
│ [x] [task plain english] │
│ [x] [task plain english] │
│ [ ] [task plain english] ← next │
│ [ ] [task plain english] │
├─────────────────────────────────────────────────────────────┤
│ COMPLETED FEATURES │
│ │
│ ✅ [Feature name] [N/N tasks] │
│ ... │
├─────────────────────────────────────────────────────────────┤
│ BACKLOG [N items deferred] │
│ [item name if ≤3] / [count only if >3] │
│ │
│ BUGS [N fixed] [N active] │
│ SCOPE CHANGES [N decisions logged] │
│ COMMITS [N this week] │
├─────────────────────────────────────────────────────────────┤
│ COST [$X.XX total · N sessions] │
│ ENV HEALTH [✅ checked this session / ⚠️ [N]h ago / ❓ not checked] │
├─────────────────────────────────────────────────────────────┤
│ Last: [last git commit — truncated to 45 chars] │
│ Next: [plain English next task] │
│ │
│ Say "next" to continue building. │
└─────────────────────────────────────────────────────────────┘
COST row logic:
- If history.json exists:
$X.XX total · N sessions
- If no history.json:
not tracked — run cost: to start
ENV HEALTH row logic:
- Checked this session (< 1h ago):
✅ checked this session
- Checked today (1-24h ago):
⚠️ checked Nh ago — consider re-running doctor:
- Not checked / no .doctor-last-run:
❓ not checked — run doctor: before building
Progress bar rendering
Bar is 20 characters wide using █ and ░:
0% ░░░░░░░░░░░░░░░░░░░░
25% █████░░░░░░░░░░░░░░░
50% ██████████░░░░░░░░░░
75% ███████████████░░░░░
100% ████████████████████
Formula: filled = round(percentage / 5), empty = 20 - filled
Status icons
✅ complete (100%)
🔄 in progress (1-99%)
⬜ not started (0%)
🔴 BLOCKED (phase gate blocked by P0 issues)
🐛 active bug fix
Edge cases
Nothing built yet:
All phases ⬜ 0%. Active section: "Start with Phase 1 — say next to begin."
Phase gates all ⬜ pending.
Active bug fix:
Add 🐛 ACTIVE BUG FIX section between ACTIVE NOW and COMPLETED FEATURES:
├─────────────────────────────────────────────────────────────┤
│ 🐛 ACTIVE BUG FIX │
│ [Bug summary plain English] │
│ [ ] BUG-001 · Write regression test ← next │
│ [ ] BUG-002 · Implement fix │
│ ... │
Review gate blocked:
Phase gates section shows 🔴 BLOCKED with the P0 count.
Active section shows the RFX- fix tasks.
No backlog:
Show: "BACKLOG 0 items deferred"
All tasks complete:
Active section: "All tasks complete — ready for review: final 🎉"
After rendering
Print nothing else. No explanations. No next steps beyond what's in the dashboard.
The dashboard is the complete output.
