Part of atlassian-cli

Jira Service Management CLI (JSM)

Automate Jira Service Management from your terminal. Service desks, requests, customers, SLAs, and queues, scriptable ITSM operations.

Jira Confluence Bitbucket JSM

atlassian-cli is an independent, community open-source project, not affiliated with, endorsed by, or sponsored by Atlassian, and is not Atlassian's official CLI (acli). Product names are used only to identify compatibility.

JSM Features

Service management automation from the command line

Service Desk Operations

List and inspect service desks. Get desk details including request types, portal settings, and queue configuration.

Request Management

List, get, and filter service requests. View request details, status, and resolution. Scriptable ticket triage workflows.

Customer Portal

Manage customers and organizations. List portal users, add customers to service desks, and audit access.

SLA Tracking

Monitor SLA compliance across service desks. Track time-to-first-response and time-to-resolution metrics via CLI.

Knowledge Base

Access knowledge base articles linked to service desks. Integrate KB content into automated workflows and runbooks.

Queue Automation

Query and manage service desk queues. Filter requests by status, priority, and assignee. Pipe output to scripts.

Code Examples

Automate service management tasks

Query Service Requests

# List recent service requests
atlassian-cli jsm request list --limit 10

# Get details of a specific request
atlassian-cli jsm request get SD-123

# Output as JSON for scripting
atlassian-cli jsm request list \
  --limit 50 --format json

# Export requests to CSV
atlassian-cli jsm request list \
  --format csv > requests.csv

Customer Management

# List service desks to find the desk ID
atlassian-cli jsm service-desk list

# List requests filtered by service desk
atlassian-cli jsm request list \
  --limit 20 --format json

# Get request details with full metadata
atlassian-cli jsm request get SD-456 \
  --format json

# Combine with Jira for cross-product views
atlassian-cli jira issue search \
  --jql "project = SD ORDER BY created DESC" \
  --limit 10

Service Desk Operations

# List all service desks
atlassian-cli jsm service-desk list --limit 10

# Get service desk details as JSON
atlassian-cli jsm service-desk list \
  --format json

# Use profiles for different instances
atlassian-cli jsm service-desk list \
  --profile production

# Combine with table output for quick overview
atlassian-cli jsm request list \
  --limit 25 --format table

JSM command groups

Every group links to its section of the full command reference.

Command group What it covers
jsm service-desk list / get / customers / add-customer / organizations List and inspect service desks; manage a desk's customers and organizations.
jsm request-type list / get / fields / groups Discover request type IDs and their required fields before raising a request.
jsm request list / get / create / transition / status / add-comment Raise, query, transition, and comment on customer requests; manage participants and subscriptions.
jsm queue list / get / issues List a service desk's queues and the issues waiting in each.
jsm approval list / get / approve / decline List and action approvals attached to a request.
jsm sla list / get Read SLA metrics such as time-to-first-response and time-to-resolution per request.
jsm customer / organization Create customers, manage organizations, and add or remove organization members.
jsm kb search Search knowledge base articles linked to a service desk.
jsm feedback get / submit / delete Read and submit customer satisfaction feedback on resolved requests.

Full flags, output schemas, and CI patterns are in the JSM command reference. For login setup see Authentication & Profiles.

Common tasks

Frequent JSM workflows, one command each

New to the tool? Walk through setup end-to-end in the JSM CLI guide, or combine these with Jira CLI for cross-product automation.

Quick Start

Set up JSM CLI access in seconds

# Install via Homebrew
brew install omar16100/atlassian-cli/atlassian-cli

# Configure authentication
atlassian-cli auth login \
  --profile work \
  --base-url https://your-domain.atlassian.net \
  --email you@company.com

# Verify connection
atlassian-cli auth test --profile work

# List your service desks
atlassian-cli jsm service-desk list

# View recent requests
atlassian-cli jsm request list --limit 5

Related Resources

Learn more about atlassian-cli

JSM CLI Guide

Step-by-step guide to automating Jira Service Management from the terminal: setup, requests, queues, and SLAs.

JSM Command Reference

Complete command reference for JSM service desk, request, customer, approvals, and SLA operations.

Jira CLI

Combine JSM with Jira CLI for cross-product automation, issues, projects, and bulk operations.

JSM CLI FAQ

Jira Service Management from the command line

How do I manage Jira Service Management from the command line?

atlassian-cli is a JSM CLI for service desks, customer requests, queues, SLAs, approvals, organizations and request types. After authenticating, run commands like atlassian-cli jsm request list --servicedesk-id 10 or atlassian-cli jsm request create --servicedesk-id 10 --request-type-id 7 --summary "...". See the full JSM command reference.

Can I create and transition JSM requests from the CLI?

Yes. Use atlassian-cli jsm request create to raise a request, jsm request transition to move it through its workflow, and jsm request add-comment to reply, all scriptable for automation.

Is atlassian-cli the official Jira Service Management CLI?

No. atlassian-cli is an independent, open-source tool and is not affiliated with, endorsed by, or maintained by Atlassian. Atlassian ships its own separate official CLI (acli).

Is the JSM CLI free?

Yes. atlassian-cli is free and open source under the MIT License. Get it on the install page or GitHub.

Copied!