YouTrack for VS Code

A third-party YouTrack Cloud client for Visual Studio Code. Sidebar, full-fidelity issue detail, agile board, time tracking, and a pile of editor-native workflows that turn the extension into a "create a ticket and keep coding" loop rather than a "read tickets while coding" loop.

Built by Valentin Beaumont. Not affiliated with JetBrains.

Features

Sidebar

• Five views in a dedicated activity-bar container: Notifications, Assigned to me, Recently opened, Issues, Agile Boards.
• Per-view filter state: text filter, state filter, tag filter, #Unresolved toggle (on by default for Assigned to me), sort mode, group-by-project. Filters on Assigned to me don't bleed into the Issues umbrella and vice-versa.
• Issues view rolls up Reported by me, Commented by me, All issues, All tickets under a single section.
• Right-click any issue → change state, assign to me, log time, create branch, copy ID/link, open in browser.

Issue detail panel

• Two-column layout with a sticky side panel. Every side-panel row — State, Priority, Assignee, and every project custom field (enum, state, user, version, bool, date, period, string, int, float) — is a clickable pill that opens a type-aware editor.
• Editable summary and description with Markdown Write/Preview tabs, a full formatting toolbar (bold, italic, strikethrough, code, code block, link, quote, bullet/numbered lists, mention), and double-click-to-edit.
• Comment drafts auto-persist per issue in globalState — close the panel, reload the window, or accidentally Ctrl+W the tab; your draft is still there when you return.
• @mention autocomplete with a VS Code-styled dropdown against the workspace user roster (arrow keys, Enter/Tab to accept, Esc to dismiss, click to pick).
• Activity feed with inline edit on your own comments. Work-item log-time form with a collapsible "Add time" trigger. Drag-and-drop attachments onto the panel. Rendered markdown is sanitized through sanitize-html under a strict CSP.
• Toolbar: Start Work (transition + branch), Timer, Branch, Refresh, Copy Link, Open in browser.

Agile board

• Sprint picker, swimlane grouping (by Priority, Assignee, or State) or flat view, column sorting (recently updated / created / ID / summary).
• Drag cards across columns to transition state.
• In-memory filters: text search (id/summary/tag) + Assignee / Priority / Tag dropdowns. Filters persist across sprint switches and window reloads.
• Create Issue button opens the form panel pre-selected to the current board's project.

Create Issue

• Two-column form panel mirroring the detail shell. Project, Type, Priority, Assignee on the right; full Markdown editor on the left with the same toolbar/tabs as comments.
• Create from editor selection: right-click on selected code → "YouTrack: Create Issue from Selection". Pre-fills summary with filename.ts:42-58 — first line of snippet and description with a fenced code block keyed to the document's language id.

Time tracking

• Live timer with a status-bar item (per-second ticker) that persists across window reloads. Stopping rounds up and posts a work item automatically.
• Standalone Log Time form on the issue panel for manual entries, with configurable work-item types.

Git integration

• Branch from issue with a configurable template — youtrack.branch.template supports {id}, {summary}, {type}, {state}, {assignee}, {project}, and {field:<CustomFieldName>} placeholders. Sanitized tokens (lowercase, diacritic-stripped, separator-joined) with a configurable length cap on {summary}.
• Current-issue status-bar badge that reads the current git branch, extracts the issue key, and shows $(tasklist) ID with a rich tooltip.
• Commit message template: when the current branch contains an issue key, the SCM input box auto-fills from youtrack.commit.template (default {id}: ). Three auto-fill modes — off, empty-only (default, inserts once on branch change), always (re-inserts after each commit) — plus a manual YouTrack: Insert Issue Key in Commit Message command. Put {id} anywhere: [{id}] , feat({id}): , or trailing \n\nRefs: {id}.
• Post branch activity: manual command that collects commits ahead of upstream on the current branch and posts them as a markdown bullet list comment on the linked issue (confirm / edit / cancel).

Editor-surface affordances

• Hover any ABC-123-shaped token in any file → summary, state, assignee, quick-open link.
• CodeLens above any TODO / FIXME / XXX / HACK / NOTE comment referencing an issue key → ABC-123 · In Progress · <summary>; click opens the panel.
• URI handler: vscode://valentinbeaumont.youtrack-vscode/ABC-123 opens the issue.

Notifications

• Unread notifications render with a bell-dot icon; inline ✓ to mark one read or a "Mark All as Read" action in the view toolbar.

Quality

• Strict CSP with per-load script nonces on every webview, sanitize-html on all rendered Markdown, no inline scripts, no eval.
• Friendly error handling: YouTrack Cloud's "read-only mode" (maintenance windows) renders as a single coalesced notice instead of raw JSON; 401/403 point to the sign-in command; other server errors render just the error_description.

Setup

1. Install the extension.
2. Ctrl+Shift+P → YouTrack: Sign In.
3. Enter your YouTrack Cloud base URL (e.g. https://<org>.youtrack.cloud/).
4. Enter a permanent token: in YouTrack go to avatar → Profile → Account Security → New token, scope it to YouTrack (not YouTrack Read-Only if you want writes to work).

Keybindings

Settings

Highlights (full list under Settings → Extensions → YouTrack):

Security

All webviews run under a restrictive CSP:

default-src 'none';
style-src  {webview}  'unsafe-inline';
font-src   {webview};
script-src 'nonce-<per-load>';
img-src    {webview}  https: data:;
connect-src {webview};
frame-src  'none';

No inline scripts, no eval, no third-party CDN assets. Rendered markdown (comments, descriptions, work-item notes) passes through sanitize-html with an explicit allow-list of tags and schemes before hitting the DOM.

Develop

npm install
npm run build        # esbuild bundle → dist/extension.js
npm test             # vitest unit suite (36 tests)
npx vsce package     # → youtrack-vscode-<ver>.vsix

Pull requests welcome at healkeiser/youtrack-vscode.

License

MIT. See LICENSE.

YouTrack and JetBrains are trademarks of JetBrains s.r.o. This extension is an independent community project and is not affiliated with, endorsed by, or sponsored by JetBrains.