ghpm-shared
ghpm — Shared Reference
Prerequisites
ghCLI installed and authenticated- Token scopes:
read:project,project - GitHub Projects v2 (not classic projects)
Config Files
All ghpm files live under .ghpm/:
| File | Purpose |
|---|---|
.ghpm/config.json |
Project config (fields, views, repos) |
.ghpm/cache.json |
Cached project items |
.ghpm/sessions/<number>.json |
Active work session per issue |
The entire .ghpm/ directory is gitignored (project-specific).
More from jackchuka/ghpm
ghpm-init
Initialize GitHub Project Management config. Auto-discovers project schema (fields, views, repos) and generates .ghpm/config.json + .ghpm/cache.json.
31ghpm-work
End-to-end work session on a GitHub Project item. Setup → Clarify → Plan → Implement → PR, with decisions captured throughout. Use when starting work on an issue, picking up a task, or resuming an interrupted session.
30ghpm-status
GitHub Project health dashboard. Shows workflow distribution, component health, team workload, items needing attention, and available views.
29ghpm-suggest
Suggest what to work on next based on project state and session context. Considers proximity, momentum, status, and constraints.
29ghpm-view
Query GitHub Project items by named view or ad-hoc filter. Shows items in board, table, or roadmap format.
28ghpm-issue
File a GitHub issue and add it to the project board. Works mid-session or standalone. Reads .ghpm/config.json for repo list and project.
15