jiradc-cli

Command-line interface for Jira Data Center. 35 commands across 6 domains — issues, projects, boards, sprints, fields, and users.

Install

npm install -g jiradc-cli

Setup

export JIRA_URL="https://jira.example.com"   # Base URL of your Jira instance
export JIRA_TOKEN="your-personal-access-token" # HTTP Access Token from Jira

Breaking changes in this release

• issue transitions now returns a bare JSON array of transitions (previously wrapped in { transitions: [...] }). Each transition is reduced to { id, name, to, fields? } — verbose fields like to.iconUrl, to.statusCategory, isGlobal, isInitial, isConditional, hasScreen are stripped.
• component list now requires --project <key> instead of a positional <projectKey> argument.
• issue link-epic is now variadic on the issue argument: link-epic <issueKey...> --epic <epicKey>. Single-issue calls keep working.

Commands

All commands output JSON. Add --pretty to pretty-print.

issue

| Command | Description | |---------|-------------| | jiradc issue get <key> | Get issue details (--fields to select, --expand for changelog/transitions) | | jiradc issue search <jql> | Search issues with JQL | | jiradc issue create | Create an issue (--project, --type, --summary, --description, --custom-fields) | | jiradc issue update <key> | Update an issue (--summary, --description, --priority, --assignee, --labels, --components, --fix-versions, or --fields JSON) | | jiradc issue delete <key> | Delete an issue | | jiradc issue assign <key> <user> | Assign issue (user can be a username, me, or none to unassign) | | jiradc issue transition <key> | Transition issue to a new status (--to accepts ID or status name, --comment to add a note) | | jiradc issue transitions <key> | List available transitions | | jiradc issue comment add <key> | Add a comment (--body) | | jiradc issue comment edit <key> | Edit a comment (--id, --body) | | jiradc issue comment delete <key> | Delete a comment (--id) | | jiradc issue link <key> <targetKey> | Link two issues (--type link type name) | | jiradc issue unlink <linkId> | Remove a link | | jiradc issue link-types | List available link types | | jiradc issue link-epic <keys...> | Link one or more issues to an epic (--epic <epicKey>) | | jiradc issue worklog add <key> | Add a work log entry (--time, --comment, --started) | | jiradc issue worklog list <key> | Get work log entries | | jiradc issue worklog edit <key> | Update a work log entry (--id, --time, --comment, --started, --adjust-estimate, --new-estimate) | | jiradc issue worklog delete <key> | Delete a work log entry (--id, --adjust-estimate, --new-estimate, --increase-by) | | jiradc issue changelog <key> | Get issue changelog | | jiradc issue batch-changelog | Get changelog for multiple issues (--keys) | | jiradc issue clone <key> | Clone an issue with subtasks | | jiradc issue batch-create | Create multiple issues from JSON | | jiradc issue dev-status <key> | Get development status (branches, PRs, commits) |

issue attachment

| Command | Description | |---------|-------------| | jiradc issue attachment list <key> | List attachments | | jiradc issue attachment download <key> <attachmentId> | Download a specific attachment | | jiradc issue attachment download-all <key> | Download all attachments | | jiradc issue attachment upload <key> <files...> | Upload files | | jiradc issue attachment delete <attachmentId> | Delete an attachment |

project

| Command | Description | |---------|-------------| | jiradc project list | List projects | | jiradc project versions <key> | List versions for a project |

component

| Command | Description | |---------|-------------| | jiradc component list | List components for a project (--project <key>) | | jiradc component get <id> | Get a component by ID | | jiradc component create | Create a component (--project, --name, --description, --lead) | | jiradc component update <id> | Update a component | | jiradc component issue-count <id> | Get the number of issues using a component |

board

| Command | Description | |---------|-------------| | jiradc board list | List boards (--project, --type: scrum/kanban/simple, --name) | | jiradc board issues <boardId> | Get issues on a board |

sprint

| Command | Description | |---------|-------------| | jiradc sprint list <boardId> | List sprints (--state: future/active/closed) | | jiradc sprint issues <boardId> <sprintId> | Get issues in a sprint | | jiradc sprint create <boardId> | Create a sprint | | jiradc sprint update <sprintId> | Update a sprint | | jiradc sprint delete <sprintId> | Delete a sprint (returns its issues to the backlog) |

field

| Command | Description | |---------|-------------| | jiradc field search | Search for fields (--query, --type: custom/system) | | jiradc field options <fieldKey> | Get allowed values for a field (--project, --issue-type) |

user

| Command | Description | |---------|-------------| | jiradc user me | Get current user info |

Pagination

Search and list commands accept --limit to control page size (Jira DC caps at 50 for agile endpoints). Responses include nextPage — pass it back as --start to fetch the next page. When nextPage is null, there are no more results.

Examples

# Get an issue with default fields
jiradc issue get AI-123

# Get an issue with specific fields
jiradc issue get AI-123 --fields summary,status,assignee,customfield_10100

# Search with JQL
jiradc issue search 'project = AI AND status = "In Development" ORDER BY updated DESC'

# Create an issue
jiradc issue create --project AI --type Task --summary "Implement feature X" --description "Details here"

# Create with custom fields
jiradc issue create --project AI --type Story --summary "User login" --custom-fields '{"customfield_10100": "value"}'

# Transition by ID or by status name
jiradc issue transitions AI-123
jiradc issue transition AI-123 --to 31
jiradc issue transition AI-123 --to "In Review" --comment "Ready for review"

# Assign
jiradc issue assign AI-123 me
jiradc issue assign AI-123 jsmith
jiradc issue assign AI-123 none

# Update with shortcuts (instead of --fields JSON)
jiradc issue update AI-123 --summary "New title" --priority High
jiradc issue update AI-123 --assignee me
jiradc issue update AI-123 --labels backend,urgent           # set mode
jiradc issue update AI-123 --labels +urgent,-backend          # mutate mode
jiradc issue update AI-123 --components +Frontend
jiradc issue update AI-123 --fix-versions 1.0,2.0

# Link multiple issues to an epic in one call
jiradc issue link-epic AI-456 AI-457 AI-458 --epic AI-100

# Add a comment
jiradc issue comment add AI-123 --body "Fixed in commit abc123"

# Delete a comment
jiradc issue comment delete AI-123 --id 12345

# Link two issues
jiradc issue link AI-123 AI-456 --type "blocks"

# Log work
jiradc issue worklog add AI-123 --time "2h 30m" --comment "Code review"

# List active sprints
jiradc sprint list 42 --state active

# Get sprint issues
jiradc sprint issues 42 100

# Find a custom field key
jiradc field search --query "story points"

# Clone an issue with subtasks
jiradc issue clone AI-123

# Get dev status (linked branches, PRs)
jiradc issue dev-status AI-123

# List components for a project
jiradc component list --project AI