fluxion-dev/lazyplan

Plan work with your coding agent, in the terminal.
lazyplan is one shared plan for you and your agent. You get a fast keyboard screen. Your agent gets a simple command line. Plans, milestones, and tasks stay in one place instead of disappearing into chat. Read-only git and PR provenance shows where each one landed.
See it in action →
## Install
bash
pipx install lazyplan-tui
lpui --help
On Windows, use the pip backend:
powershell
pipx install --backend pip lazyplan-tui
lpui --version
The shared home is %LOCALAPPDATA%\lazyplan\ and the default --actor is
%USERNAME%. Plan text is read as UTF-8 or UTF-16 and written as UTF-8, so
PowerShell 5 exports round-trip.
Prefer a system package or the one-line installer? See
install options.
## Start
bash
cd ~/my-plan
lpui # first run detects agents and creates the plan store
lpui plan add --title "my-plan" --why "reason" --what "scope"
lpui
Working with a team? lpui setup --placement repo keeps the plan in the repo.
Want demo data first? Run lpui seed.
## Why it feels different
One source of truth. The plan you see is the plan your agent reads. No copy-pasting context between chats.
Made for focus. Plans stay as one-line summaries until you open them. Detail is there when you need it.
Yours to keep. Local-first by default. Export or import any time. No account, no cloud, no lock-in.
## New in 0.30
Three themes, one key. t cycles Catppuccin Mocha, an OLED-black void,
and Latte. LAZYPLANTHEME picks one at launch, and every screen and chart
follows it.
A real GIT pane. Under the preview, the selected row shows its linked
checkouts, branch and dirty state, ahead/behind counts, newest commits, and
pull-request state.
A preview that stays put. The status, title, and breadcrumb stay fixed
while the reason, scope, next tasks, acceptance, and notes scroll beneath.
One icon language and a calmer timeline. Plans, milestones, tasks,
checkouts, commits, and pull requests share single-cell icons. The timeline
card names the scoped plan, keeps every swimlane visible, and emphasizes the
row under the cursor.
## What you get
A plan tree with progress at a glance, plus milestones and tasks underneath.
A sticky preview of the reason, the next tasks, and what done means.
A GIT pane with the checkout, commit, and pull-request context for the row.
A read-only detail page for careful reading, with quick keys to edit and move work.
Claim, blocked, gate, and attention state on the rows that need it.
One place your agent can update while you keep the big picture.
## Built to scale
The benchmark fixture holds 88 plans, 275 milestones, and 789 tasks. Query
counts are deterministic and gated on Linux and macOS per change, with the
same suite running on Windows nightly:
| Path | Before | After |
| Tree load | 909 queries / 120 ms | 12 / 48 ms |
| list --json | 7,853 / 560 ms | 18 / 62 ms |
| export --format json | 18,612 / 1,222 ms | 26 / 27 ms |
| TUI refresh | 5,148 / 557 ms | 139 / 112 ms |
Linux timings from the final sweep. See performance for
the method, budgets, and per-platform ceilings.
## How it works
Plans start as one-line summaries with progress. Open one to reveal milestones, then tasks.
The side column previews the selected row: why, what, next tasks, and acceptance progress, with a GIT card for the linked checkout and commits.