v0.9.0
v0.9.0 — Connectivity (GitHub Sync + Export + PRD Support)
This release connects OpenPlanr to the outside world: push artifacts to GitHub Issues, generate planning reports, and feed full PRDs into epic creation.
🔗 planr github — GitHub Issues Integration
Push planning artifacts to GitHub Issues with bi-directional sync. Issues are formatted with type-aware metadata tables, status badges, and collapsible artifact sources.
planr github push TASK-001 # Push a single artifact
planr github push --epic EPIC-001 # Push all artifacts under an epic
planr github push --all # Push everything
planr github sync --direction pull # GitHub → local status sync
planr github sync --direction push # Local → GitHub status sync
planr github sync --direction both # Interactive conflict resolution
planr github status # Show sync status of all linked artifacts
Each pushed artifact stores its GitHub issue number in frontmatter for bi-directional linking. Deleted issues are handled gracefully — OpenPlanr creates a new one instead of failing. Large artifact bodies use temp file delivery to avoid OS argument length limits.
📄 planr export — Planning Reports
Generate consolidated reports from your planning hierarchy in three formats.
planr export --format markdown # Markdown report
planr export --format json # Structured JSON
planr export --format html # Self-contained HTML with collapsible sections
planr export --scope EPIC-001 # Scope to a single epic
planr export --output ./reports # Custom output path
HTML reports include color-coded status badges, collapsible <details> sections, and inline CSS — no external dependencies, shareable as a single file.
📋 planr epic create --file — Full PRD Input
Epic creation now accepts detailed requirements documents instead of just one-line descriptions.
planr epic create --file requirements.md
The AI detects detailed input (>5 lines) and switches from "expand a brief" to "extract ALL requirements" — every section of your PRD is reflected in the generated epic. Token budget doubled (4K → 8K) to support richer output from large documents.
Bug fixes
- Graceful deleted issue handling — When a linked GitHub issue has been deleted, falls back to creating a new one instead of throwing an error.
- Temp file body delivery — Uses
--body-filefor GitHub issue creation/update to avoid OS argument length limits on large artifacts.
Full changelog: [v0.8.0...v0.9.0](v0.8.0...v0.9.0)