Wiz Stories
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 / blocks relationships
- 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 |
| Wiz Stories: Refresh Stories |
Reload all story views |
| Wiz Stories: Open Story |
Open story detail in a webview panel |
| Wiz Stories: Open Story File |
Open the raw markdown file |
| Wiz Stories: Set Status |
Pick a new status for a story |
| Wiz Stories: Set Priority |
Pick a new priority for a story |
| Wiz Stories: Advance Status |
Move story to ready (if pending) or complete (otherwise) |
| Wiz Stories: Archive Story |
Move story to stories/archive/ |
| Wiz Stories: Unarchive Story |
Move story back to stories/ |
| Wiz Stories: Cycle Group By |
Toggle active view grouping: status → priority → none |
Extension Settings
| Setting |
Type |
Default |
Description |
wizStories.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 install in 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.
| |
