██╗      ██╗
     ██║      ██║   your helpful jira buddy
     ██║      ██║
██   ██║ ██   ██║
╚█████╔╝ ╚█████╔╝
 ╚════╝   ╚════╝

A fast, friendly CLI for Jira Cloud. Fetch tickets as markdown, manage your sprint board in the terminal, generate sprint summaries, and pipe everything into your AI coding agent.

Install

npm install -g get-jj

Setup

1. Create a .env file in JJ's install directory, or set environment variables directly:

# Find where JJ was installed, then create .env there:
jj help  # shows install location in the banner

# Or just set env vars in your shell profile:
export JIRA_BASE_URL=https://yourcompany.atlassian.net
export [email protected]
export JIRA_API_TOKEN=your-token-here
export JIRA_PROJECT=WEB
export JIRA_BOARD_ID=36

2. You'll need these credentials:

• JIRA_BASE_URL — Your Jira Cloud URL (e.g., https://yourcompany.atlassian.net)
• JIRA_EMAIL — Your Jira account email
• JIRA_API_TOKEN — Generate one at Atlassian API Tokens
• JIRA_PROJECT — Your project key (e.g., WEB, APP, ENG)
• JIRA_BOARD_ID — Find it in your board URL: /jira/software/projects/WEB/boards/<ID>

3. Verify it works:

jj list

Install from source

git clone https://github.com/jasperfurniss/jj.git
cd jj
npm install
npm run build
npm link
cp .env.example .env  # fill in your credentials

Commands

| Command | Description | |---------|-------------| | jj | Interactive: list issues, select, view as markdown | | jj <KEY> | Fetch a specific issue (e.g., jj WEB-1234) | | jj list | List your assigned sprint issues | | jj board | Interactive kanban board — move cards between columns | | jj sprint | Sprint overview — all team issues grouped by status | | jj sprint --by-person | Sprint overview grouped by person | | jj summary | Sprint roundup — auto-copies Slack-formatted summary to clipboard | | jj summary --concise | Shorter format for quick updates | | jj ready <number> | Transition an issue to Review (e.g., jj ready 1234) | | jj open <KEY> | Open issue in browser | | jj comment <KEY> | Post a comment (-m "msg" or opens $EDITOR) | | jj create | Create an issue (-m, $EDITOR, or pipe from stdin) | | jj clone <KEY> | Clone an issue (keeps type, parent, labels) | | jj whois <name> | What's assigned to this person? | | jj search <text> | Search issues by summary | | jj help | Show all commands |

Most commands support --pipe for non-interactive, machine-readable output.

For Product Managers

JJ is built for developers and PMs. The sprint management commands are designed for the weekly rhythm of managing a Jira board:

• jj summary — The big one. Generates a Slack-ready sprint roundup covering the entire team: Sprint Focus, PTO Radar, Agenda Highlights, Key Milestones, and Primary Focus Areas broken out by person. Automatically copies to your clipboard in Slack format — just paste into your squad channel and fill in the PTO days, milestones, and commentary. Use --concise for a shorter version.
• jj sprint — Full sprint snapshot showing all team issues grouped by status. Use --by-person to see what each person is working on.
• jj whois <name> — Check someone's plate before standup or 1:1s.
• jj board — Full kanban board in your terminal. Drag cards between columns with keyboard or mouse.

Agent Integration

JJ comes with agent skills that make working with Jira a breeze in AI coding assistants.

JJ's --pipe mode outputs clean markdown to stdout, making it a perfect tool for AI agents. When your agent sees a Jira issue key like WEB-1234, it can automatically fetch the full ticket context.

Cursor

Copy the rule into your Cursor config:

cp skills/cursor-rule.mdc ~/.cursor/rules/jj.mdc

Now when you mention a Jira key in Cursor, it'll fetch the ticket automatically.

Claude Code

Append the skill to your project's CLAUDE.md (or global ~/.claude/CLAUDE.md):

cat skills/claude-code.md >> CLAUDE.md

Configuration

All configuration is via environment variables in .env. See .env.example for the full list.

Optional settings

| Variable | Default | Description | |----------|---------|-------------| | JIRA_DEFAULT_JQL | Current user's open sprint | Default query for jj list | | JIRA_OUTPUT_DIR | ./jira-output | Where downloaded attachments go | | JJ_READY_TRANSITION | REVIEW | Transition name for jj ready | | JJ_COLUMNS | ["To Do","In Progress","Review","Done"] | Board column names (JSON) | | JJ_STATUS_MAP | See .env.example | Status-to-column mapping (JSON) | | JJ_COLUMN_TRANSITIONS | See .env.example | Transition name candidates (JSON) |

License

MIT