atlassian-cli-jira

Files (1)

• SKILL.md

SKILL.md (first lines)

# Atlassian CLI Jira

Comprehensive reference for Atlassian CLI (acli) focused on Jira Cloud workflows from the command line.

**Version:** Check with `acli --version` (each CLI version is supported for 6 months after release). Some commands in the CLI structure section require ACLI 1.3.5+; if you see "unknown command", upgrade and re-check.

## Prerequisites

### Installation (macOS)

```bash
brew tap atlassian/homebrew-acli
brew install acli
acli --version
```

Or download the macOS binary:

```bash
# Intel
curl -LO "https://acli.atlassian.com/darwin/latest/acli_darwin_amd64/acli"

# Apple Silicon
curl -LO "https://acli.atlassian.com/darwin/latest/acli_darwin_arm64/acli"

chmod +x ./acli
sudo mv ./acli /usr/local/bin/acli
sudo chown root: /usr/local/bin/acli
```

### Authentication

```bash
# OAuth (browser)
acli jira auth login --web

# API token (stdin)
echo <token> | acli jira auth login --site "mysite.atlassian.net" --email "user@atlassian.com" --token

# Switch between accounts
acli jira auth switch
```

## CLI Structure

```
acli jira
├── auth
│   ├── login
│   └── switch
├── board
│   ├── list-sprints
│   └── search
├── dashboard
│   └── search
├── field
│   ├── create
│   ├── delete
│   └── cancel-delete
├── filter
│   ├── search
│   ├── list
│   └── add-favourite
├── project
│   ├── archive
│   ├── create
│   ├── delete
│   ├── list
│   ├── restore
│   ├── update
│   └── view
├── sprint
│   └── list-workitems
└── workitem
    ├── archive
    ├── assign
    ├── attachment
    │   ├── list
    │   └── delete
    ├── clone
    ├── comment
    │   ├── create
    │   ├── list
    │   ├── update
    │   ├── delete
    │   └── visibility
    ├── create
    ├── create-bulk
    ├── delete
    ├── edit
    ├── link
    │   ├── create
    │   ├── delete
    │   ├── list
    │   └── type
    ├── search
    ├── transition
    ├── unarchive
    ├── view
    └── watcher
        └── remove
```

## Command Pattern

```
acli <product> <entity> <action> [flags]
```

Example:

```
acli jira workitem create --summary "New Task" --project TEAM --type Task
```

## Output Formatting

- `--json` for JSON output (when available)
- `--csv` for CSV output (when available)

From danmestas/wardrobe, MIT.

More from danmestas/wardrobe