jira¶

• Usage: jira [flags]

Run Jira developer workflows from a terminal. Use it to read issues, build JQL, update work, manage authentication, and open the persistent dashboard.

With stdout attached to a terminal, bare jira prints help. In non-TTY or agent-detected output, bare jira emits the command schema as JSON; use jira agent schema when you want explicit discovery.

Dashboard¶

-i --interactive¶

Launch persistent dashboard from root command

ADF¶

--adf-best-effort¶

Allow lossy ADF conversions with structured warnings

--adf-strict¶

Treat lossy ADF conversions as errors

Output¶

--color <MODE>¶

Color mode; auto emits color only to a terminal and honors NO_COLOR, always overrides both

Allowed values:

• auto — detect terminal (default)
• always — force color
• never — no color

-d --debug¶

Enable debug output

--jq <EXPR>¶

Filter the JSON output with a jq expression; string results print raw, other values print as JSON per line

-o --output <MODE>¶

Output mode; compact is the JSON data without the envelope (drops ok/meta/warnings/errors)

Allowed values:

• auto — detect terminal (default)
• human — rich text
• json — JSON envelope
• compact — JSON data only

Configuration¶

-c --config <PATH>¶

Config file path

Accepts a file.

-P --profile <NAME>¶

Jira profile name

--timeout <DURATION>¶

Whole-invocation deadline (e.g. 30s, 2m); 0 disables it

Runtime¶

--max-retry-wait <DURATION>¶

Longest a request will sleep out Jira rate limits (429/503) before giving up; 0 disables auto-retry. Always capped by --timeout

Default: 30s

--no-input¶

Disable interactive prompts (implied off a TTY or in an agent; pass --no-input=false to force prompts)

Examples¶

jira -i # (1)!
jira issue list --output=json # (2)!
jira search saved my-open-bugs

1. Use the global interactive flag to open the dashboard
2. Structured output for scripts and agents

Dashboard¶

• jira tui: Launch the persistent dashboard

Jira Resources¶

• jira boards: Browse the boards visible to this profile
• jira epic: Work with Jira epics
• jira issue: Work with Jira issues
• jira jql: Build JQL queries
• jira search: Run Jira searches
• jira user: Look up Jira users
• jira worklog: Manage issue worklogs

Configuration¶

• jira alias: Manage command aliases
• jira auth: Manage Jira authentication
• jira config: Manage configuration
• jira me: Show the active profile's Jira identity
• jira release-notes: Show what's changed in jira-cli
• jira update: Update jira-cli to the latest release

Agent Discovery¶

• jira adf: Convert and lint rich text between Markdown and ADF
• jira agent: Agent tooling: schema and guide for AI coding assistants
• jira cache: Prime / inspect the local Jira metadata cache
• jira version: Print version information

Additional commands¶

• jira open: Open an issue in a browser