Installation

Install script (recommended)Copy Anchor Link

Installs the latest prebuilt binary for your OS/arch. No Go toolchain is required:

curl -sSfL https://raw.githubusercontent.com/piyush-gambhir/jira-cli/main/install.sh | sh

Pin a version or change the install directory:

curl -sSfL https://raw.githubusercontent.com/piyush-gambhir/jira-cli/main/install.sh | VERSION=0.1.1 sh
curl -sSfL https://raw.githubusercontent.com/piyush-gambhir/jira-cli/main/install.sh | INSTALL_DIR=~/.local/bin sh

Download a release manuallyCopy Anchor Link

Prebuilt binaries for every platform are attached to each GitHub Release. Download the archive for your OS/arch, extract, and put jira on your PATH:

# example (macOS arm64) — adjust the version/asset name
curl -sSfL https://github.com/piyush-gambhir/jira-cli/releases/latest/download/jira-cli_darwin_arm64.tar.gz | tar xz
sudo mv jira /usr/local/bin/

Assets are named jira-cli_<os>_<arch>.tar.gz (lowercase), where <os> is darwin or linux and <arch> is amd64 or arm64 (Windows ships as jira-cli_windows_amd64.zip).

Build from sourceCopy Anchor Link

Requires the Go 1.27+ (Go 1.27.2 recommended) toolchain. The CLI lives in the cli-go/ directory of the monorepo:

git clone https://github.com/piyush-gambhir/jira-cli.git
cd jira-cli/cli-go
make install          # builds and installs `jira` to $GOBIN / $GOPATH/bin

The binary is jira.

VerifyCopy Anchor Link

jira version

UpdatingCopy Anchor Link

jira update installs the latest release in place on macOS, Linux, and Windows. It downloads the archive for your OS/arch, verifies its SHA-256 against the release's checksums.txt, and atomically replaces the running binary (on Windows the old jira.exe is renamed to jira.exe.old and deleted on a later run). In a terminal it asks Update now? [Y/n]; pass --yes in scripts and under --no-input.

jira update --check            # current vs latest version; add -o json for scripts
jira update                    # install the latest release

If the binary's directory is not writable, nothing changes: re-run with sudo jira update, or reinstall with the install script into a directory you own (INSTALL_DIR=~/.local/bin). A binary built from source into a Go bin directory (make install) is not replaced: run git pull && make install in your jira-cli/cli-go checkout instead. --read-only blocks installing, but not --check.

Update noticeCopy Anchor Link

In an interactive terminal, jira checks GitHub for a new release at most once a day in the background and, when there is one, prints a notice on stderr after the command's output (at most once a day per version). Only the command that starts the day's check can wait for it, for at most one second:

A new version of jira is available: v0.1.10 -> v0.1.11
Update with: jira update
Release notes: https://github.com/piyush-gambhir/jira-cli/releases/tag/v0.1.11

The check never runs (no network, no output) when stderr is not a terminal, when CI is set, with --quiet or JIRA_QUIET, or for update, version, completion, and help. Turn it off with JIRA_NO_UPDATE_NOTIFIER=1 or NO_UPDATE_NOTIFIER=1.