# ox plan (https://sageox.ai/docs/cli/plan)

# 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

<Terminal>
  <TerminalCommand>ox plan [command]</TerminalCommand>
</Terminal>

## 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

<Terminal>
  <TerminalCommand>ox plan enrich --topic "add per-team rate limits" --files api/limits.go,api/router.go</TerminalCommand>
</Terminal>

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.

<Terminal>
  <TerminalCommand>ox plan enrich --file plan.md</TerminalCommand>
</Terminal>

Enrich an existing plan document (or pipe one on stdin). With no input, ox auto-discovers the newest `~/.claude/plans/*.md`.

<Terminal>
  <TerminalCommand>ox plan render --open</TerminalCommand>
</Terminal>

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.

<Terminal>
  <TerminalCommand>ox plan review my-plan-slug</TerminalCommand>
</Terminal>

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](/docs/cli/pr) - Emit a PR header that links the plans a change produced
- [ox viz](/docs/cli/viz) - Author the visualizations a rendered plan can embed
- [ox session](/docs/cli/session) - Sessions record which plan they worked on