{
  "id": "jira-cli",
  "name": "Jira CLI",
  "homepage": "https://github.com/ankitpokhrel/jira-cli",
  "description": "An interactive command-line client for Jira.",
  "executables": [
    "jira"
  ],
  "dotfiles": {
    "paths": [
      "[configHome]/.jira/.config.yml"
    ],
    "exclude": [],
    "secret": []
  },
  "commands": {
    "format": 1,
    "label": "Jira CLI",
    "description": "Search and create Jira issues. Pick a subcommand; flags without a documented long name are offered by their short form only.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": false
    },
    "subcommand": [
      {
        "path": [
          "issue",
          "list"
        ],
        "label": "List issues",
        "description": "Search issues in the current project. Output is interactive unless a plain, raw or CSV format is chosen.",
        "source": [
          {
            "id": "ref",
            "kind": "manual",
            "url": "https://github.com/ankitpokhrel/jira-cli/blob/main/README.md",
            "revision": "2026-10-27",
            "evidence": "jira issue list -yHigh -s\"To Do\" --created month -lbackend -a$(jira me)\nYou can load a specific configuration file by using the `--config/-c` flag\n# List issues created in last 7 days\n$ jira issue list --created -7d\n# List issues in status \"To Do\"\n$ jira issue list -s\"To Do\"\n# List recent issues in plain mode\n$ jira issue list --plain\n# List recent issues in raw JSON format\n$ jira issue list --raw\n# List recent issues in csv format\n$ jira issue list --csv\n# List issue in the same order as you see in the UI\n$ jira issue list --order-by rank --reverse\n# You can execute raw JQL within a given project context using `--jql/-q` option.\n$ jira issue list -q \"summary ~ cli\"\njira issue list -w\njira issue list -a\"User A\" -r\"User B\"\njira issue list -w -pXYZ\njira issue list -a$(jira me) -tBug -sDone -rFixed --reverse\n"
          }
        ],
        "field": [
          {
            "id": "status",
            "label": "Status",
            "type": "string",
            "option": [
              "-s"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "priority",
            "label": "Priority",
            "type": "string",
            "option": [
              "-y"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "assignee",
            "label": "Assignee",
            "type": "string",
            "option": [
              "-a"
            ],
            "description": "A user name, or x for unassigned.",
            "sources": [
              "ref"
            ]
          },
          {
            "id": "reporter",
            "label": "Reporter",
            "type": "string",
            "option": [
              "-r"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "label",
            "label": "Labels",
            "type": "string",
            "option": [
              "-l"
            ],
            "multiple": true,
            "sources": [
              "ref"
            ]
          },
          {
            "id": "type",
            "label": "Issue type",
            "type": "string",
            "option": [
              "-t"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "created",
            "label": "Created",
            "type": "string",
            "option": [
              "--created"
            ],
            "description": "For example -7d, week or month.",
            "sources": [
              "ref"
            ]
          },
          {
            "id": "jql",
            "label": "Raw JQL",
            "type": "string",
            "option": [
              "--jql",
              "-q"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "project",
            "label": "Project",
            "type": "string",
            "option": [
              "-p"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "watching",
            "label": "Issues I am watching",
            "type": "boolean",
            "option": [
              "-w"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "plain",
            "label": "Plain output",
            "type": "boolean",
            "option": [
              "--plain"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "raw",
            "label": "Raw JSON output",
            "type": "boolean",
            "option": [
              "--raw"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "csv",
            "label": "CSV output",
            "type": "boolean",
            "option": [
              "--csv"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "order_by",
            "label": "Order by",
            "type": "string",
            "option": [
              "--order-by"
            ],
            "suggestions": [
              {
                "value": "rank",
                "label": "Rank"
              }
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "reverse",
            "label": "Reverse order",
            "type": "boolean",
            "option": [
              "--reverse"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "config",
            "label": "Config file",
            "type": "path",
            "path": {
              "kind": "file",
              "role": "input"
            },
            "option": [
              "--config",
              "-c"
            ],
            "sources": [
              "ref"
            ]
          }
        ],
        "task": [
          {
            "id": "mine",
            "label": "Issues in a status",
            "fields": [
              "status",
              "assignee",
              "plain"
            ],
            "required": [
              "status"
            ]
          },
          {
            "id": "jql",
            "label": "Run a JQL query",
            "fields": [
              "jql",
              "plain"
            ],
            "required": [
              "jql"
            ]
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "status",
              "priority",
              "assignee",
              "reporter",
              "label",
              "type",
              "created",
              "jql",
              "plain"
            ]
          },
          {
            "id": "advanced",
            "label": "Advanced",
            "fields": [
              "project",
              "watching",
              "raw",
              "csv",
              "order_by",
              "reverse",
              "config"
            ]
          }
        ]
      },
      {
        "path": [
          "issue",
          "create"
        ],
        "label": "Create an issue",
        "description": "Create an issue non-interactively. Custom fields and Markdown templates are left out.",
        "source": [
          {
            "id": "ref",
            "kind": "manual",
            "url": "https://github.com/ankitpokhrel/jira-cli/blob/main/README.md",
            "revision": "2026-10-27",
            "evidence": "# Pass required parameters and use --no-input option to skip prompt\n$ jira issue create -tBug -s\"New Bug\" -yHigh -lbug -lurgent -b\"Bug description\" --fix-version v2.0 --no-input\nTo attach epic to an issue on creation, you can use `-P/--parent` field.\n$  jira issue create -tStory -s\"Epic during creation\" -PEPIC-42\n"
          }
        ],
        "field": [
          {
            "id": "type",
            "label": "Issue type",
            "type": "string",
            "option": [
              "-t"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "summary",
            "label": "Summary",
            "type": "string",
            "option": [
              "-s"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "priority",
            "label": "Priority",
            "type": "string",
            "option": [
              "-y"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "label",
            "label": "Labels",
            "type": "string",
            "option": [
              "-l"
            ],
            "multiple": true,
            "sources": [
              "ref"
            ]
          },
          {
            "id": "body",
            "label": "Description",
            "type": "string",
            "option": [
              "-b"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "fix_version",
            "label": "Fix version",
            "type": "string",
            "option": [
              "--fix-version"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "parent",
            "label": "Parent / epic key",
            "type": "string",
            "option": [
              "--parent",
              "-P"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "no_input",
            "label": "Skip interactive prompts",
            "type": "boolean",
            "option": [
              "--no-input"
            ],
            "sources": [
              "ref"
            ]
          }
        ],
        "task": [
          {
            "id": "create",
            "label": "Create without prompts",
            "fields": [
              "type",
              "summary",
              "priority",
              "label",
              "body",
              "no_input"
            ],
            "required": [
              "type",
              "summary",
              "no_input"
            ],
            "set": {
              "no_input": [
                true
              ]
            }
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "type",
              "summary",
              "priority",
              "label",
              "body",
              "no_input"
            ]
          },
          {
            "id": "advanced",
            "label": "Advanced",
            "fields": [
              "fix_version",
              "parent"
            ]
          }
        ]
      }
    ]
  }
}