Quick start

1. Authenticate

The API token is the simplest setup (no OAuth app required):

jira auth login --type api_token

Or non-interactively for CI/agents:

export JIRA_SITE=https://acme.atlassian.net JIRA_EMAIL=me@acme.com JIRA_TOKEN=xxxx

2. Confirm connectivity

jira whoami          # current user (also prints accountId)
jira status          # site reachability + auth check + serverInfo

3. Work

# Search with raw JQL
jira issue search "assignee = currentUser() AND statusCategory != Done" -o json

# Create an issue
jira issue create -p ABC --type Task --summary "Set up CI" -d "Details here"

# Move it and comment
jira issue transition ABC-123 "In Progress"
jira issue comment ABC-123 --body "On it"

Discovering commands

Every command has -h/--help:

jira --help
jira issue --help
jira issue create --help

Output formats

table, json, and yaml, plus the stdout/stderr contract.

Commands

The full command surface, grouped by area.