Open source · MIT

Feature plans for
LLM-assisted development.

One command sets up your project so coding agents automatically create, follow, and maintain structured feature plans across sessions.

Get started See how it works
$ uvx planager init
How it works

Plans that survive context windows.

Step 1

Install

Run uvx planager init in your project. It copies a few template files and a CLAUDE.md snippet. No config and no runtime.

Step 2

Plan

Use /planager to create a phased plan before tackling a feature. The agent explores your codebase, drafts steps, and saves a markdown file.

Step 3

Build

The agent checks, follows, and updates plans automatically every session. Use /planager-status to see progress across all features.

.plans/
Markdown plan files with frontmatter, phases, and checkboxes.
/planager
Create or resume a plan for any feature.
/planager-status
See progress across all plans in a table.
CLAUDE.md
Auto-injected snippet so agents discover plans without prompting.
Plain markdown

No special tools, just files.

Plans are markdown files checked into your repo. Any agent that can read files can follow them. Works with Claude Code, Codex, or any LLM-based workflow.

Idempotent - re-running init is safe
No background processes or servers
MIT licensed, zero dependencies 
---
feature: auth
title: User Authentication
status: in-progress
created: 2026-04-18
---

## Context

Implement email/password auth with sessions.

## Phase 1: Database schema

- [x] Create users table migration
- [x] Add password hashing utility
- [ ] Add session table migration

## Phase 2: API endpoints

- [ ] POST /login
- [ ] POST /register

## Notes

Using bcrypt. Decided against JWT.
Documentation

Getting started

Prerequisites

Planager uses uv for installation. Install it with:

curl -LsSf https://astral.sh/uv/install.sh | sh

Install

Run this from your project root:

cd your-project
uvx planager init

Idempotent - running it again skips files that already exist.

What gets created

.plans/ Directory where feature plans live (markdown files).
.claude/skills/planager/ /planager slash command for creating and resuming plans.
.claude/skills/planager-status/ /planager-status slash command for checking progress.
CLAUDE.md snippet Instructions that make agents automatically discover and follow plans.

Slash commands

/planager [description]

Create a new feature plan or resume an existing one. With a description, it explores the codebase and drafts a phased plan. Without, it lists in-progress plans.

/planager-status

Show a progress table across all plans - feature name, status, and step counts per phase.