jira-navigate

View documentation for the original command

$ tldr jira open

jira-navigate [-h] [-p PROJECT] [-b BOARD] [-q JQL] [QUERY]

-h, --help
    Display help message and exit

-v, --version
    Print version information

-p PROJECT, --project PROJECT
    Restrict navigation to specific project key (e.g., DEV)

-b BOARD, --board BOARD
    Navigate within a specific board ID or name

-q JQL, --query JQL
    Custom JQL query for filtering issues

-o, --open
    Open selected issue in default web browser

--server URL
    Override Jira base URL (e.g., https://yourcompany.atlassian.net)

--no-color
    Disable colored output

--cache
    Enable/disable query caching (default: enabled)

jira-navigate is a lightweight Linux command-line tool for browsing and managing Jira issues directly in the terminal. It connects to Jira's REST API to fetch projects, issues, epics, and sub-tasks, presenting them in an interactive, fuzzy-searchable interface powered by fzf and tree viewers.

Users can quickly search by JQL queries, filter by project or status, drill down into hierarchies, and perform actions like viewing details, transitioning states, or opening issues in the web browser. It's particularly useful for remote teams and developers embedded in terminal-heavy workflows, reducing context-switching between IDEs and web UIs.

The tool supports both Jira Cloud and Data Center/Server instances, with authentication via API tokens or OAuth. Configuration is stored in ~/.config/jira-navigate/config.yaml. No heavy dependencies; relies on common utils like curl, jq, and fzf.

Installation via cargo (Rust-based): cargo install jira-navigate. Enhances productivity by enabling keyboard-driven navigation, customizable keybindings, and integration with shell scripts for automation.

Requires API token setup in config; rate-limited by Jira API. Not compatible with Jira Free tier without token. Depends on fzf and jq for full functionality. Errors if no internet or invalid auth.

Edit ~/.config/jira-navigate/config.yaml:
{base_url: 'https://example.atlassian.net', token: 'your_api_token', user_email: 'user@example.com'}
Run jira-navigate --setup for interactive config.

jira-navigate -p PROJ (project issues)
jira-navigate -q 'assignee = currentUser()' (my assigned)
jira-navigate 'bug' (fuzzy search bugs)

Developed in 2022 by open-source contributor 'devops-toolkit' as a Rust crate. Inspired by gh CLI. Reached v1.0 in 2023 with JQL support; v2.0 (2024) added board navigation and caching.

jira(1), fzf(1), jq(1), tldr(1)