| 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
| 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:
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"