Push roadmap items to GitHub Projects via gh CLI
Syncs your roadmap items from specs/ROADMAP.toml to a GitHub Project board. Use this to keep your project management in sync with your roadmap documentation.
/plugin marketplace add linehaul-ai/linehaulai-claude-marketplace/plugin install roadmap@linehaulai-claude-marketplacePush specs/ROADMAP.toml items to GitHub Projects using the gh CLI.
gh CLI installed and authenticatedproject field)Read specs/ROADMAP.toml and parse items
/roadmap:initGet the project name from TOML header (project = "...")
Verify gh CLI is available:
gh --version
Get the GitHub Project ID:
gh project list --owner @me --format json
For each item in the roadmap:
a. Check if item already exists in project (by title):
gh project item-list <PROJECT_NUMBER> --owner @me --format json
b. If item exists, update it:
gh project item-edit --project-id <PROJECT_ID> --id <ITEM_ID> --field-id <STATUS_FIELD_ID> --single-select-option-id <STATUS_OPTION_ID>
c. If item doesn't exist, create it as a draft issue:
gh project item-create <PROJECT_NUMBER> --owner @me --title "<TITLE>" --body "<DESCRIPTION>"
Map status values:
pending → Project "Todo" columnin_progress → Project "In Progress" columndone → Project "Done" columnMap custom fields if the project has them configured:
type → "Type" field (Bug, Feature, Task)stack_layer → "Stack Layer" field (Backend, Frontend, Devops)priority → "Priority" field (P0, P1, P3)start_date → "Start Date" fieldReport sync results:
**Type:** feature | **Layer:** backend | **Priority:** P1 | **Started:** 2024-01-15