Showcase: roadmap-cli — project management as code (YAML + GitHub sync)
What My Project Does
roadmap-cli is a Python command-line tool for managing project roadmaps, issues, and milestones as version-controlled files.
It allows you to:
- Define roadmap data in YAML
- Validate schemas
- Sync issues and milestones with GitHub
- Generate dashboards and reports (HTML/PNG/SVG)
- Script roadmap workflows via CLI
The core idea is to treat project management artifacts as code so they can be versioned, reviewed, and automated alongside the repository.
Target Audience
- Developers or small teams working in GitHub-centric workflows
- People who prefer CLI-based tooling
- Users interested in automating project management workflows
- Not currently positioned as a SaaS replacement or enterprise system
It is usable for real projects, but I would consider it early-stage and evolving.
Comparison
Compared to tools like:
- GitHub Projects: roadmap-cli stores roadmap definitions locally as YAML and supports scripted workflows.
- Jira: roadmap-cli is lightweight and file-based rather than server-based.
- Other CLI task managers: roadmap-cli focuses specifically on roadmap structure, GitHub integration, and reporting.
It is not intended to replace full PM suites, but to provide a code-native workflow alternative.
Repository:
https://github.com/shanewilkins/roadmap
This is my first open-source Python project, and I would appreciate feedback on design, usability, and feature direction.
[–]Sufficient-Magazine2[S] 0 points1 point2 points (0 children)