jcli-dc

Lightweight CLI for Jira Data Center — search issues, manage sprints, and interact with your on-prem Jira instance from the terminal. All output is JSON, making it ideal for scripting and LLM-assisted workflows.

Note: This tool targets Jira Data Center (Server) REST API v2 and Agile API v1. It is not intended for Jira Cloud.

Install

npm install -g jcli-dc

Requires Node.js >= 18.

Quick Start

# Configure your Jira connection
jcli config set --url https://jira.example.com --token YOUR_PERSONAL_ACCESS_TOKEN

# Verify connectivity
jcli config test

# Get your assigned issues
jcli issue mine

Authentication

jcli uses Personal Access Tokens (PAT) — the recommended auth method for Jira Data Center 8.14+.

To create a PAT: Jira → Profile → Personal Access Tokens → Create token.

Your config is stored at ~/.jcli/config.json.

Commands

Config

| Command | Description | | ------------------------------------------------------------- | ------------------------------------- | | jcli config set --url <url> --token <pat> [--email <email>] | Save connection details | | jcli config show | Display current config (token masked) | | jcli config test | Test connectivity |

Issues

| Command | Description | | --------------------------------------------------------- | -------------------------- | | jcli issue mine | Issues assigned to you | | jcli issue mine --status "In Progress" | Filter by status | | jcli issue mine --project PROJ | Filter by project key | | jcli issue mine --max 20 | Limit results | | jcli issue get PROJ-123 | Get full issue detail | | jcli issue get PROJ-123 --comments | Include comments | | jcli issue search "project = PROJ AND status = 'To Do'" | Raw JQL query | | jcli issue comment PROJ-123 "Fixed the thing" | Add a comment | | jcli issue transitions PROJ-123 | List available transitions | | jcli issue transition PROJ-123 31 | Transition an issue | | jcli issue assign PROJ-123 jane.doe | Assign to a user |

Sprints & Boards

| Command | Description | | ------------------------------------------- | ------------------------ | | jcli sprint boards | List all boards | | jcli sprint boards --name "My Board" | Search boards by name | | jcli sprint list <boardId> | List sprints for a board | | jcli sprint list <boardId> --state active | Filter by state | | jcli sprint issues <sprintId> | List issues in a sprint |

Output

All output is JSON. Pipe to jq for filtering:

# Get just issue keys
jcli issue mine | jq '.issues[].key'

# Count by status
jcli issue mine --max 100 | jq '.issues | group_by(.status) | map({status: .[0].status, count: length})'

License

MIT