jira-ai

What This Skill Does

The jira-ai skill is a powerful command-line interface designed to streamline interaction between the OpenClaw agent and Atlassian ecosystem tools like Jira and Confluence. By bridging the gap between agent logic and project management platforms, this skill allows for programmatic issue tracking, project status reporting, and user management. It provides a robust suite of commands to fetch, update, and organize Jira issues using JQL (Jira Query Language), manage project workflows, and extract detailed user worklogs, effectively turning your AI agent into a virtual project manager.

Installation

To integrate jira-ai into your OpenClaw environment, execute the following command in your terminal:

npm install -g jira-ai

After installation, you must authorize the tool. Create a .env file containing your JIRA_HOST, JIRA_USER_EMAIL, and JIRA_API_TOKEN. Run jira-ai auth --from-file path/to/.env to secure your connection. You can further refine behavior by applying custom configurations through YAML files using the jira-ai settings --apply command.

Use Cases

• Automated Issue Triage: Automatically scan for newly created issues, assign them to team members based on labels, and update statuses as development progresses.
• Project Reporting: Generate time-based metrics and performance reports by querying issue stats or retrieving developer worklogs for specific projects.
• Documentation Integration: Seamlessly bridge Jira task management with Confluence documentation tracking using centralized CLI commands.
• Resource Management: Quickly look up team members by project and evaluate current workload capacity.

Example Prompts

1. "Jira-AI, search for all high-priority issues assigned to the dev team and summarize the current blocker count."
2. "Update issue PROJ-123: change the status to 'In Progress' and add a comment that the API integration is starting."
3. "Show me the worklog for the engineering team on the current project for the last 7 days."

Tips & Limitations

• JQL Proficiency: To get the most out of the search functionality, familiarize yourself with standard Jira Query Language syntax.
• Security: Always protect your .env file; do not commit it to version control systems.
• API Limits: Be mindful of Jira Cloud API rate limits when running automated scripts that poll for status updates or large volumes of issues.
• Consistency: Use the jira-ai settings --validate command before applying configuration changes to avoid service disruption.