youtrack

What This Skill Does

The YouTrack CLI skill provides a robust command-line interface for interacting with JetBrains YouTrack instances. It acts as an bridge between your terminal (or OpenClaw agent) and your project management environment, enabling seamless issue tracking, status updates, and reporting without leaving the command line. Whether you need to list active tasks, modify issue states in bulk, or generate project performance reports, this skill standardizes the process through a clean, intuitive CLI tool (ytctl).

Installation

To install this skill, use the ClawHub CLI tool with the following command: clawhub install openclaw/skills/skills/iahmadzain/youtrack

Once installed, ensure your credentials are configured either through the ~/.config/youtrack/config.json file or by setting the YOUTRACK_URL and YOUTRACK_TOKEN environment variables. You can generate your access token directly from the Account Security section of your YouTrack profile.

Use Cases

This skill is designed for development teams and project managers who want to optimize their workflow. Common use cases include:

• Automating routine issue updates (e.g., transitioning all tasks from 'To Do' to 'In Progress').
• Quick-searching for specific bottlenecks using YouTrack’s native query syntax.
• Generating automated summaries of project progress or individual team member activity.
• Performing bulk operations safely using the --dry-run flag to preview changes before they hit the live server.

Example Prompts

1. "Find all unresolved issues in the SP project assigned to me that have a high priority and list them in a table."
2. "Update all issues in project SP that are currently 'Open' to 'In Progress' and add a comment saying 'Starting work on this batch'."
3. "Generate a report for the SP project showing the distribution of states to see how many tickets are stuck in the backlog."

Tips & Limitations

• Safety First: Always utilize the --dry-run flag when performing bulk updates or comments to avoid accidental modifications to your issue history.
• Query Syntax: Familiarize yourself with YouTrack’s query syntax (e.g., #unresolved, sort by: priority). The more precise your query, the more efficient your bulk operations will be.
• JSON Mode: If you are piping the output of these commands into another script, append the --json flag to receive structured data that is easier to parse programmatically.
• Authentication: Ensure your token has sufficient permissions to perform the requested actions, especially for bulk operations or status updates. If you receive permission errors, check that your token scope includes 'Issue Update' rights.