labyrinthe-acli

Atlassian CLI Plugin for Claude Code

A Claude Code skills plugin that integrates the Atlassian CLI (ACLI) with multi-profile support for managing Jira issues, sprints, and admin operations across multiple Atlassian sites.

Features

• Multi-profile management — Switch between Atlassian sites/accounts within a single session
• Jira work items — Create, edit, transition, search, and manage issues
• JQL search — Query Jira with full JQL support and saved filters
• Sprint management — View boards, sprints, and backlog
• Confluence spaces — List, create, update, archive, and restore spaces
• Confluence pages — Create, view, update, and delete pages with storage format support
• Confluence search — Search content with CQL (Confluence Query Language)
• Admin operations — Manage organization users (activate, deactivate, delete)
• Cross-platform — Works on Windows, macOS, and Linux

Prerequisites

• Claude Code v1.0.33 or later (CLI, desktop app, or IDE extension)
• Node.js 18+ (required to install ACLI)
• An Atlassian Cloud account

Installation

Step 1: Add the marketplace

From within Claude Code, run:

/plugin marketplace add charlesmatte/atlassian-cli-skills

Step 2: Install the plugin

/plugin install labyrinthe-acli@atlassian-cli-skills

Choose your preferred scope when prompted:

• User — available in all your projects (recommended)
• Project — shared with collaborators via .claude/settings.json
• Local — local only, gitignored

Step 3: Reload

If you're in an active session, reload the plugin:

/reload-plugins

Alternative: Install from a local clone

git clone https://github.com/charlesmatte/atlassian-cli-skills.git

Then in Claude Code:

/plugin marketplace add ./atlassian-cli-skills
/plugin install labyrinthe-acli@atlassian-cli-skills

Getting Started

1. Install ACLI

If you don't have the Atlassian CLI installed yet, use the setup skill:

/acli-setup

Or install it manually:

# macOS
brew tap atlassian/tap && brew install acli

# Any platform with Node.js
npm install -g @atlassian/acli

Verify the installation:

acli --version

2. Authenticate with your Atlassian site

ACLI supports three authentication methods depending on your use case. Most users should start with API Token authentication.

---

Option A: API Token (recommended for most users)

API tokens let you authenticate as yourself for Jira, Confluence, and other Atlassian products.

Step 1 — Create an API token in the Atlassian portal:

1. Log in to id.atlassian.com
2. Navigate to Security > API tokens, or go directly to:
   https://id.atlassian.com/manage-profile/security/api-tokens
3. Click Create API token
4. Enter a label (e.g., Claude Code ACLI)
5. Set an expiration period (1–365 days; defaults to 1 year)
6. Click Create
7. Copy the token immediately — you cannot retrieve it after closing the dialog
8. Store it in a password manager (do not commit it to source control)

Scoped tokens (optional, more secure): Click Create API token with scopes instead to restrict the token to specific products (Jira or Confluence) and actions (view, write, delete). This is recommended for production use.

Step 2 — Find your Atlassian site name:

Your site name is the subdomain of your Atlassian Cloud URL. For example:

• URL: https://mycompany.atlassian.net → site name: mycompany.atlassian.net
• URL: https://acme-corp.atlassian.net → site name: acme-corp.atlassian.net

You can find this by logging into Jira and checking the URL in your browser's address bar.

Step 3 — Authenticate ACLI:

echo "YOUR_TOKEN" | acli jira auth login \
  --site "yoursite.atlassian.net" \
  --email "[email protected]" \
  --token

Or read the token from a file:

acli jira auth login \
  --site "yoursite.atlassian.net" \
  --email "[email protected]" \
  --token < ~/path/to/token.txt

Step 4 — Verify:

acli jira auth status

You should see your site and authenticated user displayed.

---

Option B: OAuth (for SSO organizations)

If your organization uses SSO (Single Sign-On) and you cannot use API tokens, use the browser-based OAuth flow:

1. Run:

   acli jira auth login --web
   

2. Your browser opens automatically to the Atlassian authorization page
3. Select your Atlassian site from the list
4. Click Accept to authorize ACLI
5. You'll see a confirmation in the browser — close the tab
6. Return to your terminal; authentication is complete

Verify with:

acli jira auth status

---