name: youtrack description: Interacts with YouTrack issue tracker for IdeaVim. Use when working with tickets (VIM-XXXX), adding comments, managing tags, setting status, or release management. This project does NOT use GitHub Issues - use YouTrack instead.

YouTrack Integration

This project uses YouTrack for issue tracking, NOT GitHub Issues. Commands like gh issue will NOT work.

• YouTrack URL: https://youtrack.jetbrains.com/issues/VIM
• Tickets are prefixed with VIM- (e.g., VIM-1234)

Environment Setup

All scripts require YOUTRACK_TOKEN environment variable to be set.

CLI Scripts

All scripts are in scripts-ts/src/youtrack-cli/ and run via npx tsx:

Add Comment

npx tsx scripts-ts/src/youtrack-cli/add-comment.ts <ticket-id> "<comment-text>" [--private]

Examples:

npx tsx scripts-ts/src/youtrack-cli/add-comment.ts VIM-1234 "This is a public comment"
npx tsx scripts-ts/src/youtrack-cli/add-comment.ts VIM-1234 "@Aleksei.Plate This needs review" --private

Add Tag

npx tsx scripts-ts/src/youtrack-cli/add-tag.ts <ticket-id> <tag-id>

Example:

npx tsx scripts-ts/src/youtrack-cli/add-tag.ts VIM-1234 68-507582

Remove Tag

npx tsx scripts-ts/src/youtrack-cli/remove-tag.ts <ticket-id> <tag-id>

Example:

npx tsx scripts-ts/src/youtrack-cli/remove-tag.ts VIM-1234 68-507582

Set Status

npx tsx scripts-ts/src/youtrack-cli/set-status.ts <ticket-id> "<status>"

Example:

npx tsx scripts-ts/src/youtrack-cli/set-status.ts VIM-1234 "Ready To Release"

Get Ticket Details

npx tsx scripts-ts/src/youtrack-cli/get-ticket.ts <ticket-id> [--json]

Example:

npx tsx scripts-ts/src/youtrack-cli/get-ticket.ts VIM-1234
npx tsx scripts-ts/src/youtrack-cli/get-ticket.ts VIM-1234 --json

Set Fix Version

npx tsx scripts-ts/src/youtrack-cli/set-fix-version.ts <ticket-id> "<version>"

Example:

npx tsx scripts-ts/src/youtrack-cli/set-fix-version.ts VIM-1234 "2.28.0"

Create Release Version

npx tsx scripts-ts/src/youtrack-cli/create-version.ts "<version-name>"

Example:

npx tsx scripts-ts/src/youtrack-cli/create-version.ts "2.29.0"

Delete Release Version

npx tsx scripts-ts/src/youtrack-cli/delete-version.ts "<version-name>"

Example:

npx tsx scripts-ts/src/youtrack-cli/delete-version.ts "2.29.0"

Common Tag IDs

Private Comments

Private comments are only visible to the JetBrains team. Use --private flag to make a comment private:

npx tsx scripts-ts/src/youtrack-cli/add-comment.ts VIM-1234 "@Aleksei.Plate Need review" --private

Common Workflows

Mark ticket as analyzed by Claude

npx tsx scripts-ts/src/youtrack-cli/add-tag.ts VIM-1234 68-507461

Ask for clarification (add pending tag + private comment)

npx tsx scripts-ts/src/youtrack-cli/add-tag.ts VIM-1234 68-507582
npx tsx scripts-ts/src/youtrack-cli/add-comment.ts VIM-1234 "@Aleksei.Plate I need clarification: ..." --private

Remove pending clarification tag (after owner responds)

npx tsx scripts-ts/src/youtrack-cli/remove-tag.ts VIM-1234 68-507582

Mark ticket as ready to release

npx tsx scripts-ts/src/youtrack-cli/set-status.ts VIM-1234 "Ready To Release"