BMad CodeLens

A VS Code / Cursor extension that integrates with the BMad AI-driven development workflow. It surfaces CodeLens action buttons directly above story headers in your markdown files, so you can trigger BMad AI agent commands.

What it does

When you open a BMad epic file or a story implementation file in your editor, the extension reads story IDs and their statuses and injects clickable buttons (CodeLens) above each story header. Clicking a button opens GitHub Copilot Chat with the appropriate BMad slash command and story ID pre-filled or falls back to copying the command to the clipboard if chat is unavailable.

This removes the need to manually type story IDs and slash commands, keeping you in flow while working through a BMad sprint.

Install

Download the latest .vsix from the Releases page, then install it:

# VS Code
code --install-extension bmad-codelens-<version>.vsix

# Cursor
cursor --install-extension bmad-codelens-<version>.vsix

After installing, reload the editor window (Cmd+Shift+P → "Reload Window").

Features

Epic files (### Story X.Y: Title)

Configurable action buttons appear above each story header:

• Create Story — runs /bmad-bmm-create-story (hidden when an implementation file already exists)
• Copy Story — copies the full story markdown to clipboard

When a matching implementation artifact file exists, additional controls appear:

• A status badge showing the current story status
• A Go to Story button (hidden when status is done) that opens the implementation file

Story implementation files (# Story X.Y: Title)

A single status-dependent action button appears above the header:

How it works

Clicking a button opens the Copilot Chat panel with the slash command and story ID pre-filled. If chat is unavailable, the command is copied to the clipboard instead.

Status is resolved by matching story IDs to implementation artifact files (e.g. Story 1.1 matches 1-1-*.md in implementation-artifacts/), then reading the Status: field from the file.

Configuration

Settings available under bmadCodelens.*:

Contributing

See CONTRIBUTING.md for build instructions, development setup, testing, and release process.