Cursor Plans History
Browse, preview and manage your Cursor *.plan.md history from the side bar — in VS Code and Cursor.
Cursor's Plan Mode saves each plan as a *.plan.md file under ~/.cursor/plans/. This extension adds a dedicated activity bar icon that lists every plan (global + workspace + your custom globs) and renders each one in a rich webview that mirrors Cursor's native plan view.
Features
- Activity bar view: a new icon in the primary side bar lists every plan, grouped by origin (Global / Workspace / Extra) or by date.
- Rich preview: title, overview, todo statuses with colored pills, progress bar, project badge and the full markdown body — styled with native VS Code theme colors.
- Workspace + global + custom: discovers
~/.cursor/plans/*.plan.md plus any glob you configure inside your workspace (e.g. .cursor/plans/**, docs/plans/**).
- Live updates: built-in file watcher refreshes both the tree and the open preview as soon as Cursor (or you) saves a plan.
- Quick actions: open source, reveal in OS, copy path, rename, delete (trash, with confirmation).
- Search palette:
Cursor Plans: Search Plans... quick pick across every discovered plan.
- Bilingual UI: English by default, Spanish included. Uses VS Code's native NLS so it follows the editor language automatically.
- Optional auto-preview: when
cursorPlans.useCustomEditor is on, opening a *.plan.md from the explorer also reveals the rendered preview beside the source.
Installation
Cursor
Cursor uses the Open VSX registry. Open the Extensions view (Ctrl+Shift+X), search for Cursor Plans History and click Install.
VS Code
Open the Extensions view (Ctrl+Shift+X), search for Cursor Plans History and click Install, or grab the .vsix from GitHub Releases and install it via Extensions: Install from VSIX....
Usage
- Click the Cursor Plans icon in the activity bar (primary side bar).
- The view lists every plan it discovers.
- Click a plan to open the rendered preview.
- Right-click for
Open Source, Reveal in File Explorer, Copy Path, Rename, Delete.
Settings
| Setting |
Type |
Default |
Description |
cursorPlans.globalPlansDir |
string |
~/.cursor/plans |
Path to the global Cursor plans directory. |
cursorPlans.includeWorkspace |
boolean |
true |
Include workspace plans matched by workspaceGlobs. |
cursorPlans.workspaceGlobs |
string[] |
[".cursor/plans/**/*.plan.md"] |
Globs relative to each workspace folder. |
cursorPlans.extraGlobs |
string[] |
[] |
Extra workspace-relative or absolute globs to scan. |
cursorPlans.groupBy |
source | date | none |
source |
How tree items are grouped. |
cursorPlans.sortBy |
modified-desc | modified-asc | name |
modified-desc |
Sort order inside each group. |
cursorPlans.useCustomEditor |
boolean |
false |
Auto-open the rendered preview beside *.plan.md files. |
cursorPlans.confirmDelete |
boolean |
true |
Ask before deleting a plan. |
Plans use a YAML frontmatter block followed by markdown:
---
name: My Feature
overview: One-line description shown under the title.
todos:
- id: setup
content: Install dependencies
status: completed
- id: build
content: Wire the new module
status: in-progress
isProject: false
---
## Body
Free-form markdown rendered as the body of the preview.
Allowed todos[].status values: pending, in-progress, completed, error.
Build from source
npm install
npm run build
npm run package # builds the .vsix
To run the test suite locally:
npm test
Publishing (maintainer notes)
The release workflow publishes to both marketplaces from the same .vsix:
- VS Code Marketplace via
@vscode/vsce (VSCE_PAT secret).
- Open VSX (mirrored by Cursor) via
ovsx (OVSX_PAT secret).
Tag the release (vX.Y.Z) and push the tag to trigger .github/workflows/release.yml.
License
MIT — see LICENSE.
