PlanX is a planning skill for Claude Code, Codex and other AI coding agents, plus a terminal interface for reviewing plans with versions, diffs, inline feedback and direct edits.
Planning is not a ritual you perform to make an agent feel prepared. It is for you to decide what will be built.
PlanX turns the giant blob of text you read once and lose in chat into a versioned artifact you can actually review:
- [1] Create structured plans.
- [2] Compare every revision.
- [3] Give feedback on exact lines.
- [4] Execute the version you approve.
Plan with one agent and build with another. Claude Code writes the plan, you review it, Codex builds it — or any two agents you like, in any order.
npm install --global @thisisnsh/planxThat installs the planx TUI you review plans in, and automatically installs
the PlanX skill for detected Claude Code and Codex installations.
Or install the skill on its own with
skills:
npx skills add thisisnsh/planxAlso listed on Smithery and LobeHub.
PLAN → REVIEW → REVISE → EXECUTE → RESUME
Fun fact: this README was recreated using PlanX. Every image below is that plan, being reviewed.
Using the planning skill, the agent researches the work, writes a structured plan, captures it as a version and hands it back for review.
More in The skill.
What comes back is a stored version rather than a message in a scrollback: structured markdown with headings that fold, the context the work needs, and the checks that prove it at the end.
More in Planning and Reviewing.
Press
space
to collapse the section, feedback box or unchanged diff run under the cursor,
h to
fold every comment at once,
j to
jump between comments,
[ ]
to jump between section titles, and
? for the full
key list. A long plan stays walkable instead of becoming a scroll.
More in Reviewing.
Put the cursor on a line and press
v,
extend the selection with the arrows, then press
f.
The comment attaches to those exact lines, not to the plan in general. Press
n
for a note about the whole plan, or
e to
rewrite a line yourself when the right wording is already obvious.
More in Feedback and edits.
Press s and
pick a hand-off. PlanX can resume the session that wrote the plan, so it revises
with the repository research still in context — or send the same review to
another agent entirely, which starts from the plan and your comments and nothing
else.
More in Hand-offs.
Each revision is a new version of the same plan. Open it and PlanX shows a
word-level diff against the one before, with unchanged runs collapsed, so a
rewritten approach cannot slip past as a wall of re-flowed text. Press
d to
show or hide the diff.
More in Versions and diffs.
Any agent command that takes a trailing prompt can build the plan. Set them once
with
planx defaults
— one command to revise, another to execute, whichever pair you like — and the
review offers them beside the built-in routes. The receiving agent needs nothing
but the PlanX skill.
More in Hand-offs, Custom agents and Resuming a build.
planx remove-skills
npm uninstall --global @thisisnsh/planxMore in CLI reference.
Every key, command and flag is written down in the PlanX wiki.
Installation · The skill · Reviewing · CLI reference
Not sure what to do with PlanX? Ask your agent /planx help what can you do?
You can ask specific questions too, like
/planx help how do I comment on a single line?
More in Asking for help.
Anything the wiki does not cover can be asked in Q&A
Have something PlanX should do? Post it in Ideas
If PlanX made a plan easier for you to review, please star it on GitHub.
It tells me the tool is worth continuing, and it is how the next person who is tired of losing plans in a scrollback finds it.
Feel free to contact author at hello at thisisnsh dot com
Wiki · Q&A · Ideas · Contributing · Security · MIT License · Smithery · LobeHub