SprintManager

CLI tool to manage GitHub Project V2 sprints for the ciroos-ai engineering board.

Prerequisites

• Python 3.10+
• uv (curl -LsSf https://astral.sh/uv/install.sh | sh)

Setup

1. Install GitHub CLI

# Ubuntu/Debian
sudo apt install gh

# macOS
brew install gh

# Other: https://github.com/cli/cli/blob/trunk/docs/install_linux.md

2. Authenticate

gh auth login

Select GitHub.com, HTTPS, and authenticate via browser. Then add the project scope:

gh auth refresh -s project

Verify:

gh auth status

You should see project in the scopes list.

3. Clone and run

git clone <repo-url>
cd SprintManager

No dependencies to install -- the tool uses Python stdlib only.

Commands

List sprints

uv run python sprint_manager.py list-sprints              # last 12 sprints
uv run python sprint_manager.py list-sprints --count 5     # last 5 sprints

List contributors

uv run python sprint_manager.py contributors                  # all project contributors
uv run python sprint_manager.py contributors --sprint 26.1.4   # per-sprint with done/open stats
uv run python sprint_manager.py contributors --sprint last      # last completed sprint

List issues for a sprint

uv run python sprint_manager.py issues 26.1.4             # by sprint title
uv run python sprint_manager.py issues current             # current active sprint
uv run python sprint_manager.py issues last                # last completed sprint
uv run python sprint_manager.py issues 26.1.4 --users alice        # single user
uv run python sprint_manager.py issues 26.1.4 --users alice,bob   # multiple users

Migrate issues between sprints

Move all non-Done issues from the last completed sprint to the current sprint:

uv run python sprint_manager.py migrate --dry-run          # preview first
uv run python sprint_manager.py migrate                     # execute migration

Specify source/target sprints:

uv run python sprint_manager.py migrate --from 26.1.3 --to 26.2.1

Migrate specific users' issues:

uv run python sprint_manager.py migrate --users alice --dry-run
uv run python sprint_manager.py migrate --users alice,bob

Notes

• Sprint references accept a title (e.g. 26.1.4), current (first active sprint), or last (most recent completed sprint).
• migrate skips issues with status Done -- only open work carries forward.
• Use --dry-run to preview before making changes.
• The tool paginates through all project items (can take a moment on large boards).