YouTrack
Full YouTrack integration — search issues, manage assignments, add comments, track time, browse projects and knowledge base articles.
@elyracode/youtrack gives the agent direct access to your YouTrack instance. Search and create issues, update fields, log work, link issues together, and read knowledge base articles — all without leaving your Elyra session.
Install
elyra install npm:@elyracode/youtrack
Configuration
Set the following environment variables (or add them to your .env file):
| Variable | Description |
|---|---|
YOUTRACK_BASE_URL |
Your YouTrack instance URL — e.g. https://myteam.youtrack.cloud |
YOUTRACK_TOKEN |
Permanent token from YouTrack (Profile → Authentication → New Token) |
Tools
| Tool | Description |
|---|---|
youtrack_search_issues |
Search issues using YouTrack query syntax |
youtrack_get_issue |
Get full details of a single issue by ID |
youtrack_create_issue |
Create a new issue in a project |
youtrack_update_issue |
Update fields on an existing issue |
youtrack_delete_issue |
Delete an issue |
youtrack_list_comments |
List comments on an issue |
youtrack_add_comment |
Add a comment to an issue |
youtrack_list_tags |
List available tags |
youtrack_apply_tag |
Apply or remove a tag on an issue |
youtrack_list_links |
List links on an issue (duplicates, subtasks, related) |
youtrack_add_link |
Add a link between two issues |
youtrack_list_projects |
List all accessible projects |
youtrack_get_project |
Get project details and custom field schema |
youtrack_list_users |
List users in the YouTrack instance |
youtrack_get_current_user |
Get the authenticated user's profile |
youtrack_search_articles |
Search knowledge base articles |
youtrack_get_article |
Get a knowledge base article by ID |
youtrack_add_work_item |
Add a time tracking work item to an issue |
Query syntax
Use these query terms with youtrack_search_issues:
| Query | Meaning |
|---|---|
for: me |
Issues assigned to the current user |
by: me |
Issues reported by the current user |
#Unresolved |
Open issues |
#Resolved |
Resolved issues |
project: PROJ |
Issues in a specific project |
Priority: Critical |
Issues with a specific priority |
Type: Bug |
Issues of a specific type |
created: today |
Issues created today |
created: this week |
Issues created this week |
sort by: Priority desc |
Sort by priority, highest first |
Combine freely: project: PROJ #Unresolved for: me sort by: Priority desc
Issue creation workflow
Always get the project schema before creating an issue:
> Create a bug in the PROJ project
The agent will call youtrack_get_project first to discover required custom fields and allowed values, then youtrack_create_issue with the correct payload — preventing validation errors.
Examples
> Show my open issues
> Create a bug: login page throws 500 on empty password
> Add a comment to PROJ-123: fixed in the latest deploy
> Log 2 hours on PROJ-456
> Link PROJ-123 as a duplicate of PROJ-100
> Search for unresolved critical bugs in the backend project
> What articles cover our deployment process?
Included skill
The elyra-youtrack skill is loaded automatically. It teaches the agent YouTrack query syntax, the issue creation workflow (get schema → create), and how to interpret issue IDs like PROJ-123.