ox plan
Work with SageOx-enriched implementation plans: enrich, render, and review. ox computes team-context signals (collision, prior-art, expert-routing) locally, with no LLM or network call.
Lifecycle verbs (approve, work, realize, abandon, supersede) are thin sugar over one event-log engine. Each accepts --json and is idempotent: re-running an already-applied verb is a safe no-op.
Usage
Subcommands
| Command | Description |
|---|---|
ox plan enrich | Enrich an implementation plan with SageOx team context (JSON by default) |
ox plan render | Render a plan to a self-contained HTML page |
ox plan review | Open a live review loop for a saved plan (serve, collect, auto-reload, approve) |
ox plan list | Browse saved Ledger plans |
ox plan view | Read a saved plan in the terminal |
ox plan status | Show a saved plan's lifecycle timeline and current status |
ox plan approve | Mark a saved plan approved |
ox plan work | Record that a coding session worked on a saved plan |
ox plan realize | Mark a saved plan realized (its intent was carried out) |
ox plan abandon | Mark a saved plan abandoned |
ox plan supersede | Mark a saved plan superseded by a successor plan |
Examples
Consult team context before drafting a plan. Returns JSON badges (collision, prior-art, expert-routing) at zero LLM and network cost. Add --text for a human-readable summary.
Enrich an existing plan document (or pipe one on stdin). With no input, ox auto-discovers the newest ~/.claude/plans/*.md.
Render a plan to a self-contained HTML page and open it in your browser. On a saved plan, --open launches the live review loop, pass --static for a read-only page instead.
Serve a saved plan on a short-lived localhost server and stay up across review rounds. Reviewers mark up sections, risks, and decisions; each round writes to the Ledger and prints a digest for the agent.
What's next
- ox pr - Emit a PR header that links the plans a change produced
- ox viz - Author the visualizations a rendered plan can embed
- ox session - Sessions record which plan they worked on