jirac
A fast, feature-rich Jira CLI built in Rust.
jirac is an opinionated Jira terminal client that fills the gaps left by existing CLIs: full custom field support via runtime introspection, native attachment uploads, cursor-based pagination, and full compatibility with Jira REST API v3.
It ships as a single binary with no runtime dependencies, runs on macOS, Linux, and Windows, and includes an interactive TUI, an MCP server for editor/agent integrations, and a Claude Code plugin.
Preview
Installation
Homebrew (macOS / Linux)
brew tap mulhamna/tap && brew install jira-commands
Shell script (macOS / Linux)
curl -sSL https://raw.githubusercontent.com/mulhamna/jira-commands/main/install.sh | bash
Cargo
cargo install jira-commands
Pre-built binaries and archives
Download from GitHub Releases.
For manual installs, prefer the packaged archives. They include the binary plus license files and README.
Releases now publish the supported binaries jirac and jirac-mcp. The legacy jira binary is no longer shipped in release artifacts.
| Platform | Raw binary | Preferred archive |
|---|
| macOS (Apple Silicon) | jirac-macos-aarch64 | jirac-macos-aarch64.tar.gz |
| macOS (Intel) | jirac-macos-x86_64 | jirac-macos-x86_64.tar.gz |
| Linux (x86_64) | jirac-linux-x86_64 | jirac-linux-x86_64.tar.gz |
| Linux (ARM64) | jirac-linux-aarch64 | jirac-linux-aarch64.tar.gz |
| Windows (x86_64) | jirac-windows-x86_64.exe | jirac-windows-x86_64.zip |
Quick start
1. Create an API token
Go to Atlassian API tokens and create a new token.
2. Authenticate
jirac auth login
You will be prompted for your Jira base URL, email, and API token. Credentials are stored in ~/.config/jira/config.toml with 600 permissions.
3. Start using it
jirac issue list # your assigned issues
jirac issue list -p PROJ # issues in a project
jirac issue view PROJ-123 # view issue detail
jirac issue create -p PROJ # create (interactive)
jirac issue transition PROJ-123 --to Done # transition
jirac tui -p PROJ # interactive TUI
Usage
Issues
jirac issue list # assigned to you
jirac issue list -p PROJ # by project
jirac issue list --jql "status = 'In Progress'" # custom JQL
jirac issue view PROJ-123 # view detail
jirac issue create -p PROJ # create (interactive)
jirac issue create -p PROJ --type Bug --summary "Login fails on Safari"
jirac issue update PROJ-123 --summary "New title"
jirac issue update PROJ-123 --assignee user@co.com
jirac issue transition PROJ-123 # interactive picker
jirac issue transition PROJ-123 --to "In Progress"
jirac issue attach PROJ-123 ./screenshot.png
jirac issue delete PROJ-123
Worklogs
jirac issue worklog list PROJ-123
jirac issue worklog add PROJ-123 --time 2h --comment "Fixed auth bug"
jirac issue worklog delete PROJ-123 --id 10234
Bulk operations
jirac issue bulk-transition -p PROJ -q 'status = "To Do"' -t "In Progress"
jirac issue bulk-update -p PROJ -q 'status = Done' --field assignee --value me@co.com
jirac issue archive -p PROJ -q 'status = Done AND updated < -90d'
JQL builder
jirac issue jql # interactive
Raw API passthrough
jirac api get /rest/api/3/serverInfo
jirac api post /rest/api/3/issue --body '{"fields":{...}}'
Plans (Jira Premium)
jirac plan list
Auth management
jirac auth login
jirac auth status
jirac auth update --token NEW_TOKEN
jirac auth update --url https://new.atlassian.net
jirac auth logout
Interactive TUI
jirac tui # your assigned issues
jirac tui -p PROJ # specific project