Linear TODO Comments

A VS Code extension that detects TODO comments in your code, links them to Linear issues, and shows issue details on hover. Supports multiple comment formats out of the box.

Fork of linear-todos by dtran, with configurable pattern matching, performance improvements, and UI enhancements.

Features

• Flexible TODO detection: Recognizes TODO MAV-1234, [MAV-1234] TODO, TODO (MAV-1234), Linear URLs, and more
• Configurable patterns: Choose which formats to recognize via VS Code settings
• Issue preview on hover: See the issue title, status, assignee, priority, labels, and description
• Prefetching: Issues are fetched in the background when you open a file, so hovers are instant
• Create issues: Turn unlinked TODOs into Linear issues with code context
• Visual indicators: Highlighted TODOs with different colors for linked vs unlinked

Requirements

• VS Code 1.65.0+
• Linear account
• Linear Connect extension

Quick Start

1. Install the extension
2. Authenticate with Linear when prompted
3. Run Configure Linear Integration from the command palette to select your team
4. Hover over any TODO with a Linear issue ID to see details

Settings

Recognized Formats

With all formats enabled (["bare", "brackets", "parens", "url"]):

// TODO MAV-1234 fix the bug           (bare)
// TODO: MAV-1234 fix the bug          (bare)
// [MAV-1234] TODO: fix the bug        (brackets)
// TODO (MAV-1234): fix the bug        (parens)
// https://linear.app/maven/issue/MAV-1234/slug  (url, requires linearOrg)

Commands

• Create Linear Issue from TODO — create an issue from a TODO comment
• Open Linear Issue — open the linked issue in your browser
• Refresh TODOs — rescan the current file
• Configure Linear Integration — select your Linear team

License

MIT. Based on linear-todos by dtran.