Install Guide

Install atlassian-cli

Install atlassian-cli in under a minute. Homebrew, Cargo, or a prebuilt binary — macOS, Linux, Windows. Free and open source (MIT).

Independent open-source project — not affiliated with, endorsed by, or maintained by Atlassian.

Install with Homebrew

Recommended for macOS and Linux. Updates automatically via brew upgrade.

brew install omar16100/atlassian-cli/atlassian-cli

The formula lives in the omar16100/atlassian-cli tap. After install, run atlassian-cli --version to verify.

Install with Cargo

Works anywhere the Rust toolchain runs. Compiles from source.

cargo install atlassian-cli

The crate is published at crates.io/crates/atlassian-cli. Requires Rust 1.75+.

Prebuilt binary download

No build toolchain required. Signed releases for macOS (Intel + Apple Silicon), Linux (x86_64 + aarch64), and Windows.

Download the latest release from GitHub →

Extract the archive and place the binary anywhere on your $PATH, e.g. /usr/local/bin or ~/.local/bin.

Verify the install

atlassian-cli --version
atlassian-cli --help

You should see the version number (currently 0.3.3) and the top-level help text.

First-time setup

Configure a profile once, reuse it everywhere.

# Jira / Confluence / JSM (API token)
atlassian-cli auth login \
  --profile work \
  --base-url https://your-domain.atlassian.net \
  --email you@company.com

# Bitbucket Cloud (bearer token)
atlassian-cli auth login \
  --profile bb-ci \
  --bitbucket --bearer \
  --workspace myteam

# Test it
atlassian-cli auth test --profile work

Credentials are stored with AES-256-GCM encryption at ~/.config/atlassian-cli/credentials. See Jira CLI, Confluence CLI, or Bitbucket CLI for product-specific commands.

Troubleshooting