Skip to content

jira alias set

  • Usage: jira alias set NAME EXPANSION... [flags]

Store a local shortcut that expands to another jira command before Cobra parses argv. Use it for repeated searches, profile-specific workflows, or long flag combinations.

The stored expansion is parsed back to an argv with POSIX shell grammar. When EXPANSION reaches jira alias set as a single shell-quoted string, it is stored verbatim. When EXPANSION arrives as multiple argv tokens, each token is quoted before storage so the round trip stays faithful.

A hand-edited config alias must follow the same grammar: an unquoted # starts a comment and everything after it is dropped. Quote a literal #, for example '#tag', to keep it.

Safety

--dry-run

Preview the alias without writing the config file

Output fields

With --output json, the response envelope's data object carries these fields. Run jira agent schema for the full machine-readable schema.

Field Type Description
dry_run boolean
expansion string
name string
previous string

Examples

jira alias set mine "issue list --assignee me" # (1)!
jira alias set bugs "search jql 'type = Bug AND status = Open'" # (2)!
jira alias set mybugs "issue list --assignee me --output=json" # (3)!
  1. Alias "mine" to list issues assigned to you
  2. Store a multi-word expansion as a single quoted string
  3. Alias a JSON-friendly search for agents