Install atlassian-cli — Homebrew, Cargo, prebuilt binaries

Q: How do I install atlassian-cli with Homebrew?

Run 'brew install omar16100/atlassian-cli/atlassian-cli'. This installs the atlassian-cli binary on macOS or Linux. Verify with 'atlassian-cli --version'.

Q: How do I install atlassian-cli with Cargo?

If you have the Rust toolchain, run 'cargo install atlassian-cli'. You can also download a prebuilt binary from the GitHub releases page or use the shell installer script.

Q: Which platforms does atlassian-cli support?

Prebuilt binaries are available for macOS (Apple Silicon and Intel) and Linux (gnu and musl). It also installs from source via Cargo on any platform with a Rust toolchain.

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.4.2) 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

command not found — ensure the install directory is on your $PATH. For Homebrew on Apple Silicon, that's /opt/homebrew/bin.
brew install fails with "no such tap" — run brew tap omar16100/atlassian-cli first, then brew install atlassian-cli.
cargo install is slow — use prebuilt binaries or Homebrew; Cargo compiles from source.
authentication fails — Atlassian Cloud requires an API token, not your account password.

Install FAQ

Getting atlassian-cli onto your machine

How do I install atlassian-cli with Homebrew?

Run brew install omar16100/atlassian-cli/atlassian-cli on macOS or Linux, then verify with atlassian-cli --version.

How do I install atlassian-cli with Cargo?

With the Rust toolchain installed, run cargo install atlassian-cli. You can also grab a prebuilt binary from GitHub releases or use the shell installer script above.

Which platforms does atlassian-cli support?

Prebuilt binaries cover macOS (Apple Silicon and Intel) and Linux (gnu and musl). It also builds from source via Cargo on any platform with a Rust toolchain.

Is atlassian-cli the same as Atlassian's official acli?

No. atlassian-cli is an independent, open-source project and is not Atlassian's official acli. If you specifically want Atlassian's first-party CLI, install acli from Atlassian. atlassian-cli is a separate, free, MIT-licensed tool for Jira, Confluence, Bitbucket and JSM.