# Install jiratui with Homebrew, Nix

Textual User Interface for interacting with Atlassian Jira from your shell. Version 1.10.1 via Homebrew; verified 2026-07-04.

## Install

```sh
sudo av install brew:jiratui
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install jiratui
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#jiratui
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ji/jiratui/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:jiratui
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/jiratui>
- **Version:** 1.10.1
- **Source summary:** Textual User Interface for interacting with Atlassian Jira from your shell
- **Homepage:** <https://jiratui.sh/>
- **Repository:** <https://github.com/whyisdifficult/jiratui>
- **Upstream docs:** <https://jiratui.readthedocs.io/en/latest>
- **License:** MIT
- **Source archive:** <https://files.pythonhosted.org/packages/69/d8/e7f5afe6e0a5876ac54faa55ffe0cd1f6d3ca9d8cbecbdda02e4c5f96677/jiratui-1.10.1.tar.gz>
- **Last updated:** 2026-07-04T18:39:59Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- jiratui (cli)
- jiratui (alias)

## Dependencies

- certifi
- cryptography
- libmagic
- libyaml
- pillow
- pydantic
- python@3.14

## Build dependencies

- rust

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.10.1
- Package-manager updated: 2026-07-04
- Local data: ok
- Upstream repository: https://jiratui.sh/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

JiraTUI is a Python terminal user interface and CLI for Atlassian Jira. It is built with Textual and Rich, supports Jira Cloud REST API v3 and v2, and stores Jira credentials and settings in an XDG-style YAML configuration file.

### Project history

The project had its first public release in September 2025. Its README frames it as a TUI for interacting with Jira directly from the shell, with both an interactive `jiratui ui` application and command groups for issues, comments, users, themes, configuration, and version information.

Version 1.0.0 followed quickly after the first 0.x releases and moved configuration to the XDG file layout while dropping the old `JIRA_TUI_ENV_FILE` configuration path. Later releases added API v2 support, work-item editing improvements, navigation features, and history-oriented UI conveniences.

### Adoption history

JiraTUI's public history is short, but it already uses several packaging channels familiar to Python CLI users: PyPI, uv tool installation, pip, pipx, AUR, Homebrew, and Nix. Its README also documents Linux, macOS, and Windows support, which helps the TUI reach developers across common terminal environments.

### How it is used

Users configure `jira_api_username`, `jira_api_token`, and `jira_api_base_url` in `config.yaml`, optionally select cloud or on-premise behavior, and run `jiratui ui` for the full TUI. The CLI side supports searching, updating, and deleting work items, managing comments, searching users and groups, listing themes, and printing the configuration file location.

### Why package nerds care

JiraTUI represents the newer Textual/Rich generation of Python TUIs: more application-like than a plain CLI, but still installed and launched like a normal package-manager tool. It is interesting beside `jira-cli` because both target Jira from the terminal, yet JiraTUI leans into a full-screen interface rather than a GitHub-CLI-style command tree.

### Timeline

- 2025: v0.1.0 was published as the first JiraTUI release.
- 2025: v1.0.0 introduced the XDG configuration layout and removed `JIRA_TUI_ENV_FILE` support.
- 2025: v1.1.0 added Jira Cloud REST API v2 support alongside API v3.
- 2026: v1.8.0 and v1.8.1 continued the 1.x release line.
- 2026: v1.9.0 added parent-key autocomplete, a Go-To screen, keybinding-hint configuration, and a view of work-item history.

### Related projects

- JiraTUI is directly related to Textual, Rich, Atlassian Jira REST APIs, and terminal applications such as Posting, Lazygit, and Harlequin, which the README credits as inspirations. It also overlaps in purpose with `jira-cli`.

### Sources

- <https://api.github.com/repos/whyisdifficult/jiratui/releases/tags/v1.0.0>
- <https://api.github.com/repos/whyisdifficult/jiratui/releases/tags/v1.9.0>
- <https://api.github.com/repos/whyisdifficult/jiratui/releases?per_page=100>
- <https://github.com/whyisdifficult/jiratui>
- <https://jiratui.readthedocs.io/>
- <https://pypi.org/pypi/jiratui/json>


## Security Notes

generalized runtime or code generation signal.

- **Geiger risk:** yellow / medium
- generalized runtime or code generation signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: $XDG_CONFIG_HOME/jiratui/config.yaml, ~/.config/jiratui/config.yaml

## Credential files

- Unix: $XDG_CONFIG_HOME/jiratui/config.yaml, ~/.config/jiratui/config.yaml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** jiratui
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - jiratui: normalized package name match | nixpkgs package indexes: pkgs/by-name/ji/jiratui/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Related links

- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Productivity CLI packages](https://www.automicvault.com/pkg/productivity-cli-packages/) - Matched curated productivity category metadata from av.db.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [bagels](https://www.automicvault.com/pkg/brew/bagels/) - Shares av.db curated category or tags: cli, productivity, terminal, tui.
- [circumflex](https://www.automicvault.com/pkg/brew/circumflex/) - Shares av.db curated category or tags: cli, productivity, terminal, tui.
- [dooit](https://www.automicvault.com/pkg/brew/dooit/) - Shares av.db curated category or tags: cli, productivity, terminal, tui.
- [lf](https://www.automicvault.com/pkg/brew/lf/) - Shares av.db curated category or tags: cli, productivity, terminal, tui.
- [midnight-commander](https://www.automicvault.com/pkg/brew/midnight-commander/) - Shares av.db curated category or tags: cli, productivity, terminal, tui.
- [mprocs](https://www.automicvault.com/pkg/brew/mprocs/) - Shares av.db curated category or tags: cli, productivity, terminal, tui.
- [newsboat](https://www.automicvault.com/pkg/brew/newsboat/) - Shares av.db curated category or tags: cli, productivity, terminal, tui.
- [nom](https://www.automicvault.com/pkg/brew/nom/) - Shares av.db curated category or tags: cli, productivity, terminal, tui.
- [vit](https://www.automicvault.com/pkg/brew/vit/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, interface, productivity, python, python-3-14.

## Combined YAML source

View the package source record on GitHub. [combined/jiratui.yml](https://github.com/automic-vault/db/blob/main/combined/jiratui.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
