Youtrack
ProductivityyoutrackYoutrack is an Agent Skill for productivity published in the aiskillstore/marketplace repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/aiskillstore/marketplace/blob/HEAD/skills/jetbrains/youtrack/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/youtrack, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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"