ji

Jira CLI built with Bun. Supports agentic analysis of issues.

Installation

# Install Bun runtime
curl -fsSL https://bun.sh/install | bash

# Install ji
bun install -g @aaronshaf/ji

Getting Started

ji setup

This will set up your Atlassian credentials and configure your AI tool (optional).

Common Commands

Daily Workflow

# View your assigned issues
ji mine

# View current sprint
ji sprint

# View project board
ji board PROJ

# View a specific issue (two ways)
ji PROJ-123
ji issue view PROJ-123

# Take ownership of an issue
ji take PROJ-456

# Add comment
ji comment PROJ-456 "Hello, world!"

# Analyze an issue with AI
ji analyze PROJ-789
ji analyze PROJ-789 --comment

Key Features

AI-Powered Analysis

ji analyze PROJ-123           # Output analysis to terminal
ji analyze PROJ-123 --comment # Analyze and post as comment
ji analyze PROJ-123 --comment -y  # Auto-post without confirmation
ji analyze PROJ-123 --prompt custom.md  # Use custom prompt file

The analyze command:

• Fetches issue details and analyzes with AI (Claude, Gemini, or opencode)
• Generates actionable recommendations
• Outputs clean analysis text by default
• Use --comment flag to post as Jira comment
• Auto-detects available AI tools or uses configured preference
• Works best when run from the code directory/repo related to the Jira issue for context-aware analysis

Custom Analysis Prompts

You can customize the AI analysis by providing your own prompt file:

ji analyze PROJ-123 --prompt ~/my-prompts/security-review.md

Users are encouraged to create their own analysis prompts tailored to their specific needs. If no custom prompt is specified, ji uses the default prompt located at src/assets/default-analysis-prompt.md.

To set a persistent custom prompt, configure it during setup:

ji setup  # Will prompt for analysis prompt file path

Documentation

• Command Reference - Complete list of commands and options
• Development Guide - Setup, architecture, and contributing
• Publishing Guide - NPM package publishing instructions

Upgrading

To upgrade ji to the latest version:

bun update -g @aaronshaf/ji

After upgrading, you may want to review new configuration options:

ji setup  # Review and update your configuration

Contributing

See DEVELOPMENT.md for setup instructions and contribution guidelines.

License

MIT