# Plan Version History

> DB-backed plan snapshots: when they are taken, how to list and inspect them, and what `restore-plan-version` preserves. Use when the user asks about plan history, undo, rollback, or restoring an earlier version of a plan.

- Skill: `builderio/plan-version-history` (Agent Skill)
- Install (CLI): `npx skillmds@latest add builderio/plan-version-history`
- Raw SKILL.md: https://api.skillmd.com/api/skills/builderio/plan-version-history/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Builder.io (https://skillmd.com/u/builderio)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/builderio/plan-version-history

---


# Plan Version History

- Plans keep DB-backed snapshots before meaningful authoring changes. Pure
  comments, feedback replies, and comment status changes do not create history
  snapshots.
- Use `list-plan-versions` to see saved snapshots for a plan, and
  `get-plan-version` to inspect one full snapshot before recommending a
  rollback.
- Use `restore-plan-version` only when the user asks to restore or roll back.
  The current plan is snapshotted first with `Before restore`, so restore is
  reversible. Restore preserves sharing, ownership, hosted publish metadata,
  comments, and activity history; it restores the plan's authoring content and
  legacy sections.

## Related Skills

- **plan-hosted-writes** — the write protocol that triggers snapshots.