project-board-manager

What problem does it solve?

Bridges the gap between raw GitHub Issues and a visual Kanban board by using GitHub Projects to orchestrate project states and improve visibility across the repository.

Core Features & Use Cases

• Board Initialization: Creates or ensures a GitHub Projects board exists for the repository using the gh project create command and explicitly links it to the repository with gh project link so it appears under the repository's Projects tab.
• Issue Linking: Reads the generated task.md for issue numbers and links them to the project board using gh project item-add, enabling centralized tracking.
• Board Organization: Sets up standard Kanban columns such as Todo, In Progress, In Review, and Done, and updates item states as work progresses (e.g., when a branch is created or a PR is merged) using gh project item-edit if needed.
• Use Case: Teams adopting a single source of truth for project state can automatically reflect issue progress on a shared Kanban board, reducing context switching and improving visibility.

Quick Start

Create and link a GitHub Project board for the current repository and attach generated issues to it.