Home

PlanX

PlanX turns a plan from Claude Code, Codex or another AI coding agent into a stored, versioned artifact you can read, annotate and approve outside the agent. The same skill and terminal review work across agents. Claude Code and Codex have first-class setup, session recording and resuming; other agents can install the skill and use custom hand-off commands.

PLAN → REVIEW → REVISE → EXECUTE → RESUME

What PlanX gives you

• A stored plan that survives the chat and is identified by an exact version.
• A terminal review with folding, line comments, plan-wide notes and direct edits.
• Word-level diffs between revisions, with unchanged sections collapsed.
• A hand-off that builds the version you approved, not whichever version is newest.
• The freedom to plan with one agent and revise or build with another.
• Session recording and resuming when PlanX knows how to restart the agent.

Start here

Page	What it covers
Installation	Installing the CLI, where the skills and the store land
The skill	/planx and $planx, and the five branches they dispatch on
Why review an agent's plan	The case for reading the plan properly, and what skimming costs
Plan mode vs. a reviewable plan	How PlanX relates to the plan mode your agent already has
Planning with Claude Code	/planx, the capture, the review, the hand-off
Planning with Codex	$planx, why the sigil differs, and planning across two agents

Using PlanX

Page	What it covers
Planning	What the agent does on the plan branch, and the shape of a captured plan
Reviewing	The picker, the review screen, and every key on both
Feedback and edits	Line feedback, the plan-wide note, and direct edits
Versions and diffs	Moving between versions and reading the diff
Hand-offs	s, the six exits, and what the receiving agent gets
Resuming a build	ctrl+r back into the session that built a version
Custom agents	planx defaults, and planning and building in different agents

Reference

Page	What it covers
CLI reference	Every command and flag, generated from the source
Troubleshooting	When something is not where you expect it
FAQ	Short answers, one question at a time
Asking for help	/planx help <question>, answered from this wiki

Questions and ideas

Ask your agent first: /planx help <question> reads this wiki and answers in chat — see Asking for help. Anything it does not cover, ask in Q&A — how a key works, whether a workflow is supported, why something behaves the way it does. Have something PlanX should do? Post it in Ideas, where it can be talked through before anyone builds it.