Open Source · MIT Licensed · v1.0

Your AI agent writes code.
Now it reads the plan first.

OpenPlanr is a CLI that generates structured agile plans and teaches Claude Code, Cursor, and Codex to gather full project context before writing a single line of code.

View on GitHubnpm →
~/my-project
// The Protocol

What your agent does before
writing a single line

The generated rules file teaches your AI coding agent a 4-step context-gathering protocol. No more blind coding.

  1. Read the Task
    Parse subtasks, frontmatter IDs, status, and parent references from the task list artifact.
    TASK-001.md → frontmatter
  2. Walk the Parent Chain
    Story with Gherkin acceptance criteria → Feature requirements → Epic business context.
    Task → Story → Feature → Epic
  3. Read Architecture
    ADRs, checklists, project rules, and architecture decisions that constrain the solution space.
    .planr/rules.md + ADRs
  4. Scan the Codebase
    Tech stack, source tree, dependency chains, patterns, and related files for full implementation context.
    stack + tree + patterns
// Features

Everything you need.
Nothing you don't.

A complete agile planning toolkit that lives in your terminal and your repo. No accounts, no subscriptions.

  • AI-Powered Planning
    Generate a full agile hierarchy from a one-line brief or a detailed PRD. Epics, features, stories with Gherkin, and task lists — cascaded automatically.
    $planr plan --epic EPIC-001
  • Backlog Capture
    Capture ideas in under a second without breaking flow. AI prioritizes by impact and effort. Promote to tasks or stories when you’re ready.
    $planr backlog add "user profiles"
  • Sprint Planning
    Time-boxed iterations with AI task selection based on velocity, subtask complexity, and feature priority. Velocity charts track progress across sprints.
    $planr sprint create --auto
  • Task Templates
    5 built-in templates for REST endpoints, React components, DB migrations, API integrations, and auth flows. Save your own from any task list.
    $planr template use rest-endpoint
  • Effort Estimation
    AI-powered story points on the Fibonacci scale with hours, complexity, risk factors, and reasoning. Epic rollup aggregates across all tasks.
    $planr estimate TASK-001 --save
  • Quality Guardrails
    Auto-extracted pattern rules from your codebase. Post-generation validation catches file path errors and dependency gaps before you accept AI output.
    5 heuristic detectors
  • GitHub Sync
    Push artifacts to GitHub Issues with type-aware formatting. Bi-directional status sync — pull, push, or interactive conflict resolution.
    $planr github push --epic EPIC-001
  • Export Reports
    Generate consolidated reports in Markdown, JSON, or self-contained HTML with collapsible sections, status badges, and full hierarchy rendering.
    $planr export --format html
  • Smart Rules
    Generates native rule files for each coding agent. Your agent reads the plan, architecture, and codebase patterns before every implementation.
    $planr rules generate
// Agent Support

Works with the agents
you already use

No plugins. No extensions. Just the rules file your agent already reads.

Claude Code
CLAUDE.md
Full context protocol with task parsing, parent chain walking, and codebase scanning.
Cursor
.cursor/rules/*.mdc
6 structured rule files that activate when your agent opens a task for implementation.
Codex
AGENTS.md
Autonomous agent instructions with the same 4-step context-gathering protocol.

Built with itself.

Every feature in OpenPlanr started as a backlog item, moved through the agile hierarchy, and was implemented by AI agents guided by the rules OpenPlanr generates. The tool is its own proof of concept.

Give your AI agent
the full picture.

Open source. MIT licensed. Get started in 30 seconds.

$ npm install -g openplanr && planr init

Requires Node.js 20+

TypeScriptNode.jsCommander.jsHandlebarsZodBiome