Browse and manage Wiz file-stories from your VS Code sidebar.
Features
- Active Stories — sidebar tree view showing stories from
stories/, grouped by status or priority - Archived Stories — separate view for stories in
stories/archive/ - Dependencies — dedicated view showing stories with
blocked-by/blocksrelationships - Story Detail — click a story to open a rendered webview with metadata badges, markdown content, and clickable dependency links
- Inline Actions — set status, set priority, mark complete, archive, and unarchive from the tree view context menu
- Auto-Refresh — file watcher detects changes to story files and refreshes views automatically
- Open Raw File — quickly jump to the underlying markdown file for direct editing
Prerequisites
- VS Code 1.85.0 or later
- A
stories/directory in your workspace (the extension activates only when this exists) - Stories are created and managed via the Wiz CLI (
stories-cli.js), not by this extension
Story File Format
Story files are markdown with YAML frontmatter:
---
id: "WIZ-001"
status: ready
priority: P1
type: feature
category: ui
blocked-by: WIZ-002, WIZ-003
blocks: WIZ-004
created: "2026-04-01"
updated: "2026-04-08"
---
# Story Title
Story description in markdown...
Status Values
| Status | Description |
|---|---|
pending |
Not yet triaged |
ready |
Ready to work on |
in-progress |
Currently being worked on |
blocked |
Blocked by a dependency |
complete |
Done |
wontfix |
Will not be addressed |
Priority Values
P1 (highest), P2, P3 (lowest)
Dependency Fields
| Field | Description |
|---|---|
blocked-by |
Comma-separated list of story IDs this story depends on |
blocks |
Comma-separated list of story IDs this story is blocking |
Directory Structure
your-workspace/
stories/
WIZ-001.md
WIZ-002.md
archive/
WIZ-000.md
Commands
| Command | Description |
|---|---|
| Mission Control: Refresh Stories | Reload all story views |
| Mission Control: Open Story | Open story detail in a webview panel |
| Mission Control: Open Story File | Open the raw markdown file |
| Mission Control: Set Status | Pick a new status for a story |
| Mission Control: Set Priority | Pick a new priority for a story |
| Mission Control: Advance Status | Move story to ready (if pending) or complete (otherwise) |
| Mission Control: Archive Story | Move story to stories/archive/ |
| Mission Control: Unarchive Story | Move story back to stories/ |
| Mission Control: Cycle Group By | Toggle active view grouping: status → priority → none |
Extension Settings
| Setting | Type | Default | Description |
|---|---|---|---|
missionControl.groupBy |
string |
"status" |
How to group stories in the active view (status, priority, or none) |
Development
Running locally with F5
- Open this repo in VS Code
- Run
npm installin the terminal - Press F5 — VS Code will compile the extension and open an Extension Development Host window with the extension loaded
- In the dev host window, open any folder that contains a
stories/directory (you can use this repo itself) - The Stories sidebar will appear and activate automatically
Tip: Use ⇧⌘F5 to restart the dev host after making code changes.
Building from Source
npm install
npm run compile
To create a .vsix package for local installation:
npx @vscode/vsce package
Known Issues
See CHANGELOG.md for version history.