Lightweight story management in VS Code. Stories that travel with your code.
Stories live as markdown files in your repo—version-controlled, AI-accessible, and completely free.
Organize work into epics and stories. Filter by sprint to focus on what matters now.
Press Cmd+Shift+S to capture ideas without leaving your code. Supports type prefixes (bug:, feat:) and inline notes.
Hover over any [[TASK-001]] link to see the full story card—status, type, size, sprint, and more.
Status bar shows real-time progress for your filtered sprint.
Use quick capture for fast ideas or the full form for detailed stories with templates.
- Story Templates — Different templates per type (feature/bug/task/chore)
- Auto-timestamps —
updatedfield auto-updates on save - Status Toggle — Right-click to change status
- Clickable Links —
[[STORY-ID]]links open the story file
-
Install from VS Code Marketplace (search "DevStories")
-
Initialize — Run
DevStories: Initfrom Command Palette (Cmd+Shift+P) -
Create your first epic — Run
DevStories: Create Epic -
Start capturing stories — Press
Cmd+Shift+Sor click the+button
| Action | Shortcut |
|---|---|
| Quick Capture | Cmd+Shift+S |
| Command Palette | Cmd+Shift+P |
DevStories stores configuration in .devstories/config.json:
{
"project": "My Project",
"idPrefix": {
"epic": "EPIC",
"story": "STORY"
},
"statuses": [
{ "id": "todo", "label": "To Do" },
{ "id": "in_progress", "label": "In Progress" },
{ "id": "done", "label": "Done" }
],
"sprints": {
"current": "sprint-1",
"sequence": ["sprint-1", "sprint-2", "backlog"]
}
}your-project/
└── .devstories/
├── config.json
├── epics/
│ ├── EPIC-001.md
│ └── EPIC-INBOX.md
├── stories/
│ ├── STORY-001.md
│ └── STORY-002.md
└── templates/
└── feature.md
See CONTRIBUTING.md for development setup.