LinuxCommandLibrary

jira-project

TLDR

List all projects

$ jira project [[ls|list]]
copy

Display help
$ jira project [[-h|--help]]
copy

SYNOPSIS

jira-project <command> [flags]
Common commands: list, browse, show

PARAMETERS

--list
    List all accessible projects with summary info

--plain
    Output in plain text format for easy parsing

--template string
    Custom Go template for output formatting

--project string
    Filter or target specific project by key/ID

--no-color
    Disable colored output

-H, --host string
    Jira host URL (overrides config)

--insecure
    Skip TLS certificate verification

DESCRIPTION

The jira-project command is a subcommand of the popular jira-cli tool, enabling users to interact with Atlassian Jira projects directly from the Linux terminal. It supports listing projects accessible to the authenticated user, retrieving project details, and browsing project boards.

Built in Go, it integrates seamlessly with Jira Cloud and Server/Data Center instances. Authentication is handled via personal access tokens or OAuth, stored securely in the user's home directory. This command is invaluable for developers and teams embedding Jira workflows into scripts, CI/CD pipelines, or daily command-line operations, reducing reliance on the web UI.

Key features include plain-text output for scripting, customizable templates for JSON/CSV export, and filtering by project keys or types (e.g., software, service desk). It respects Jira permissions, showing only projects the user can access.

CAVEATS

Requires prior authentication with jira configure; supports Jira Cloud/Server but may need version-specific flags; rate-limited by Jira API.

EXAMPLES

jira-project list --plain # List projects in plain text
jira-project list --template 'table{{ .Key }} {{ .Name }}' # Custom table output

CONFIGURATION

Run jira configure first to set host, user, and token. Config stored in ~/.config/jira/config.yml.

HISTORY

Part of jira-cli by Ankit Pokhrel, initial release in 2020. Evolved with Jira API v3 support; v2.x added templating and better error handling (2023). Actively maintained with 10k+ GitHub stars.

SEE ALSO

jira(1), curl(1), jq(1)

Copied to clipboard