--- 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 ```bash npx tsx scripts-ts\/src\/youtrack-cli\/add-comment.ts "" [--private] ``` Examples: ```bash 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 ```bash npx tsx scripts-ts\/src\/youtrack-cli\/add-tag.ts

``` Example: ```bash npx tsx scripts-ts\/src\/youtrack-cli\/add-tag.ts VIM-1234 68-507582 ``` ### Remove Tag ```bash npx tsx scripts-ts\/src\/youtrack-cli\/remove-tag.ts

``` Example: ```bash npx tsx scripts-ts\/src\/youtrack-cli\/remove-tag.ts VIM-1234 68-507582 ``` ### Set Status ```bash npx tsx scripts-ts\/src\/youtrack-cli\/set-status.ts "" ``` Example: ```bash npx tsx scripts-ts\/src\/youtrack-cli\/set-status.ts VIM-1234 "Ready To Release" ``` ### Get Ticket Details ```bash npx tsx scripts-ts\/src\/youtrack-cli\/get-ticket.ts [--json] ``` Example: ```bash 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 ```bash npx tsx scripts-ts\/src\/youtrack-cli\/set-fix-version.ts "" ``` Example: ```bash npx tsx scripts-ts\/src\/youtrack-cli\/set-fix-version.ts VIM-1234 "2.28.0" ``` ### Create Release Version ```bash npx tsx scripts-ts\/src\/youtrack-cli\/create-version.ts "" ``` Example: ```bash npx tsx scripts-ts\/src\/youtrack-cli\/create-version.ts "2.29.0" ``` ### Delete Release Version ```bash npx tsx scripts-ts\/src\/youtrack-cli\/delete-version.ts "" ``` Example: ```bash npx tsx scripts-ts\/src\/youtrack-cli\/delete-version.ts "2.29.0" ``` ## Common Tag IDs | Tag Name | Tag ID | |----------|--------| | claude-analyzed | `68-507461` | | claude-pending-clarification | `68-507582` | | IdeaVim Released In EAP | `68-385032` | ## Private Comments Private comments are only visible to the JetBrains team. Use `--private` flag to make a comment private: ```bash 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 ```bash npx tsx scripts-ts\/src\/youtrack-cli\/add-tag.ts VIM-1234 68-507461 ``` ### Ask for clarification (add pending tag + private comment) ```bash 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) ```bash npx tsx scripts-ts\/src\/youtrack-cli\/remove-tag.ts VIM-1234 68-507582 ``` ### Mark ticket as ready to release ```bash npx tsx scripts-ts\/src\/youtrack-cli\/set-status.ts VIM-1234 "Ready To Release" ```