Skip to content
progress-tracker logo

progress-tracker

Track and report progress across autonomous coding sessions. Use when generating progress reports, calculating metrics, visualizing completion, or estimating time to completion.

NeverSight/skills_feed0installs214stars

SKILL.md

Full skill instructions

Progress Tracker

Tracks and reports progress across autonomous coding sessions with metrics, visualization, and completion estimation.

Quick Start

Get Progress Metrics

from scripts.progress_tracker import ProgressTracker

tracker = ProgressTracker(project_dir)
metrics = tracker.get_progress()

print(f"Features: {metrics.passing}/​{metrics.total}")
print(f"Progress: {metrics.percentage:.1f}%")

Generate Report

report = tracker.generate_report(format="markdown")
print(report)

Visualize Progress

visualization = tracker.visualize_progress()
print(visualization)
# ████████████░░░░░░░░ 60% (30/​50)

Progress Dashboard

┌─────────────────────────────────────────────────────────────┐
│                    PROGRESS DASHBOARD                        │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  Overall Progress                                            │
│  ████████████████░░░░░░░░░░░░░░░░░░░░  45%                  │
│                                                              │
│  Features: 45/​100 passing                                    │
│  Sessions: 12 completed                                      │
│  Commits: 87 made                                            │
│                                                              │
│  By Category                                                 │
│  ├─ auth:     ████████████████████ 100% (5/​5)              │
│  ├─ crud:     ██████████████░░░░░░  70% (14/​20)            │
│  ├─ ui:       ████████░░░░░░░░░░░░  40% (12/​30)            │
│  ├─ api:      ██████████████████░░  90% (9/​10)             │
│  ├─ testing:  ██░░░░░░░░░░░░░░░░░░  10% (2/​20)             │
│  └─ other:    ██████░░░░░░░░░░░░░░  30% (3/​10)             │
│                                                              │
│  Estimated Completion                                        │
│  ├─ At current rate: ~15 sessions remaining                 │
│  ├─ Time estimate: ~7.5 hours                               │
│  └─ Sessions per day: 3                                     │
│                                                              │
└─────────────────────────────────────────────────────────────┘

Metrics Tracked

MetricDescription
FeaturesPassing/​total feature count
Progress %Completion percentage
SessionsNumber of sessions completed
CommitsNumber of git commits
VelocityFeatures per session
ETAEstimated sessions to completion

Integration Points

  • context-state-tracker: Reads feature and progress data
  • coding-agent: Tracks feature completion
  • autonomous-loop: Uses metrics for continuation decisions

References

  • references/​METRICS.md - Detailed metrics documentation
  • references/​REPORT-FORMATS.md - Report format options

Scripts

  • scripts/​progress_tracker.py - Core ProgressTracker class
  • scripts/​metrics_calculator.py - Metrics calculations
  • scripts/​report_generator.py - Report generation
  • scripts/​visualization.py - ASCII visualization