Sprints

⚠️ BETA — GitScrum CLI is in active development. Open source under the MIT license. Available on GitHub. Built for developers — Tasks, timers, sprints, and analytics in your terminal. Git-aware. CI/CD ready.

Sprint management from your terminal. Burndown charts, velocity tracking, and sprint health — all in ASCII.

Commands

List Sprints

gitscrum sprints

SLUG        NAME         STATUS    DATES                 PROGRESS
sprint-14   Sprint 14    Planned   Feb 17 - Feb 28       0%
sprint-13   Sprint 13    Active    Feb 3 - Feb 14        65%
sprint-12   Sprint 12    Closed    Jan 20 - Jan 31       100%

Filter by Status

gitscrum sprints --status active
gitscrum sprints --status closed
gitscrum sprints --status planned

Current Sprint

gitscrum sprints current

Sprint 13 — "Q1 API Improvements"
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Duration: Feb 3 - Feb 14 (Day 5 of 10)
Progress: 65% complete

METRICS
  Total points:      52 pts
  Completed:         34 pts
  Remaining:         18 pts
  Velocity:          6.8 pts/day

TASKS
  Done:              12 tasks
  In Progress:        4 tasks
  Todo:               6 tasks
  Blocked:            1 task

STATUS: On track to complete by Feb 14

Burndown Chart

gitscrum sprints burndown

Sprint 13 Burndown (Day 5 of 10)

52 │●
48 │  ●
44 │    ●
40 │      ●
36 │        ●
32 │          ●  ← Actual
28 │            ·
24 │              ·
20 │                ·
16 │                  · ← Ideal
12 │                    ·
 8 │                      ·
 4 │                        ·
 0 └──────────────────────────────
     1  2  3  4  5  6  7  8  9  10

Remaining: 18 pts | Velocity: 6.8 pts/day
Status: On track ✓

For Specific Sprint

gitscrum sprints burndown sprint-12

View Sprint Details

gitscrum sprints view sprint-13

Sprint 13 — "Q1 API Improvements"
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Status: Active
Dates:  Feb 3 - Feb 14

GOAL:
  Complete OAuth implementation and API pagination fixes

TASKS (22 total):
  CODE      TITLE                          STATUS        PTS
  GS-1234   Implement OAuth flow           Done          5
  GS-1198   Fix pagination bug             In Progress   2
  GS-1201   Add caching layer              Blocked       8
  GS-1156   Unit tests for auth            Todo          3
  ... (18 more tasks)

TEAM:
  john:     15 pts assigned, 10 pts done
  alice:    12 pts assigned, 8 pts done
  bob:       8 pts assigned, 6 pts done

Create Sprint

gitscrum sprints create --name "Sprint 14" --start 2026-02-17 --end 2026-02-28

Created: sprint-14 (Sprint 14)
Duration: Feb 17 - Feb 28

Flags

Close Sprint

gitscrum sprints close sprint-13

Sprint 13 closed.

SUMMARY:
  Completed:   34 pts (65%)
  Carried over: 18 pts (8 tasks moved to backlog)
  Duration:     10 days
  Velocity:     3.4 pts/day

Sprint Velocity

Track team velocity over time:

gitscrum sprints --json | jq '.[] | {name, completed_points, velocity}'

{"name": "Sprint 12", "completed_points": 48, "velocity": 4.8}
{"name": "Sprint 11", "completed_points": 42, "velocity": 4.2}
{"name": "Sprint 10", "completed_points": 45, "velocity": 4.5}

Daily Standups

Combine with standup commands for daily check-ins:

# See what the team completed yesterday
gitscrum standup

# Check blockers
gitscrum standup blockers

CI/CD Integration

Sprint Report on Schedule

# GitHub Actions - Weekly sprint report
name: Sprint Report
on:
  schedule:
    - cron: '0 9 * * 1'  # Monday 9 AM

jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - name: Sprint status
        run: |
          gitscrum sprints current --json > sprint.json
          # Send to Slack, email, etc.

Block Deploy if Sprint Unhealthy

- name: Check sprint health
  run: |
    STATUS=$(gitscrum sprints current --json | jq -r '.status')
    if [ "$STATUS" = "at_risk" ]; then
      echo "Sprint at risk. Consider resolving blockers before deploy."
      exit 1
    fi