{"id":16057939,"url":"https://github.com/pascalgn/jiracli","last_synced_at":"2025-03-18T05:30:27.016Z","repository":{"id":50117406,"uuid":"77873018","full_name":"pascalgn/jiracli","owner":"pascalgn","description":"JIRA Command Line Interface","archived":false,"fork":false,"pushed_at":"2022-06-28T14:19:04.000Z","size":539,"stargazers_count":10,"open_issues_count":3,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-28T07:11:58.194Z","etag":null,"topics":["java","jira-cli","jira-rest-api"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pascalgn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-01-03T01:15:57.000Z","updated_at":"2023-08-30T08:21:14.000Z","dependencies_parsed_at":"2022-07-31T17:49:00.663Z","dependency_job_id":null,"html_url":"https://github.com/pascalgn/jiracli","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pascalgn%2Fjiracli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pascalgn%2Fjiracli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pascalgn%2Fjiracli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pascalgn%2Fjiracli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pascalgn","download_url":"https://codeload.github.com/pascalgn/jiracli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243902293,"owners_count":20366260,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","jira-cli","jira-rest-api"],"created_at":"2024-10-09T03:05:31.217Z","updated_at":"2025-03-18T05:30:25.770Z","avatar_url":"https://github.com/pascalgn.png","language":"Java","readme":"# Jiracli\n\nJiracli is a command line interface for Jira to automate common tasks and perform advanced bulk changes.\n\n* [Examples](#examples)\n* [Usage](#usage)\n* [License](#license)\n\n## Examples\n\nInitialization and command chaining:\n\n    $ java -jar jiracli.jar -c\n    jiracli\u003e issues JRA-123 JRA-321 | filter -f key 'JRA-123' | print '${summary} [${status.name}]'\n    Base URL: https://jira.atlassian.com\n    New Report: Voted Issues [Closed]\n    jiracli\u003e exit\n\nSearch and issue filtering:\n\n    jiracli\u003e search \"project=JRA and text~'new report'\" | filter -e -f summary '^New report' | print\n    JRA-2020 - New reports tab + report\n\nJavaScript evaluation: \n\n    jiracli\u003e issues JRA-123 | js -l \"forEach.call(input, function(issue) { println(issue.fields.issuetype.name); })\"\n    Suggestion\n\n    jiracli\u003e js \"webService.getIssue('JRA-123')\" | parse\n    JRA-123\n\n    jiracli\u003e echo \"Hello\\nWorld\\nHello, world!\" | split | filter -j \"/^Hello/.test(input)\"\n    Hello\n    Hello, world!\n\nIssue browsing:\n\n    jiracli\u003e issues JRA-123 | browse -n\n    https://jira.atlassian.com/browse/JRA-123\n\n## Usage\n\nJiracli can be started in one of two modes, GUI and console mode.\nAfter startup, Jiracli presents a command prompt to execute commands.\nFor information about available commands, see the section [Commands](#commands).\n\nAlmost all commands accept positional arguments, indicated by angle brackets in the help text:\n\n    jiracli\u003e echo -h\n    usage: echo [-h] [--] [\u003ctext\u003e...]\n\nOptional arguments for commands are prefixed with a single or double dash.\nUsually, both short (`-s`) and long forms (`--long`) can be used.\n\nA double dash can be used to separate positional from optional arguments,\nwhen necessary (`echo -- -h`).\n\nCommands can be chained by using the pipe symbol (`cmd1 | cmd2`),\npassing the output of the first command to the second command.\nUnlike traditional Unix shells, Jiracli passes objects instead\nof plain text between commands. This allows chaining of multiple\nmodifications, for example:\n\n    jiracli\u003e issues JRA-123 | set summary 'Hello' | set description 'World' | update\n\n#### Authentication\n\nWhen using Jira Cloud, you need to create an API token for Jiracli by following these steps:\n\n1. Go to https://id.atlassian.com/manage/api-tokens, create a new API token\n2. When Jiracli asks for a password when using a command, paste you API token there\n\n```\nPlease enter the credentials for https://jira.atlassian.net\nUsername: your_jira_account_email@mail.com\nPassword: [ENTER_YOUR_API_TOKEN_HERE]\n```\n\nYou can also provide your credentials using the `JIRACLI_USERNAME` and `JIRACLI_PASSWORD`\nenvironment variables.\n\n### Commands\n\nThis section describes some of the basic commands. To get a list of all commands, type `help`.\n\n#### Load issues\n\n* `issues` can be used to load specific issues (`issues JRA-1 JRA-7 JRA-123`)\n  or to find issues belonging to the input object (`boards | sprints | issues`)\n* `read` reads text from a given file (`read my-issues.txt | parse -k`)\n* `search` executes the given JQL script and returns the issues (`search 'project = JRA and issuetype = Epic'`)\n\n#### Relationships\n\n* `links` displays all issues linked to another issue (`issues JRA-1 | links`)\n\n#### Transformations\n\n* `sort` changes the order of the input list (`search 'summary ~ bug' | sort -f priority`)\n* `filter` returns only the matching items of a list (`sprints -s 10123 | issues | filter -f issuetype Task`)\n* `head` limits the output to the first 10 (by default) items (`search 'assignee = currentUser()' | head`)\n\n#### Issue modifications\n\n* `set` sets the given field to the given value (`issues JRA-123 | set summary Test | print`).\n  However, when using `set`, `update` must be called to actually send the modifications\n  to the server (`issues JRA-123 | set summary Test | update`)\n* `labels` can be used to add or remove labels from the given issues. Like `set`, the\n  changes will only be permanent after calling `update` (`search 'summary ~ bug' | labels -a Bug | update`)\n* `edit` opens the issues in an external editor, so that multiple issues may be edited at once.\n  Like `set`, the changes will only be permanent after calling `update` (`issues JRA-234 | edit | update`)\n* `transition` can be used to change the status of issues. The issue's workflow is used\n  to determine a path from the current status to the target status. If multiple\n  paths are found, the shortest is used (`issues JRA-123 | transition -n Closed`)\n* `link` creates a relationship between the input and the given issue (`issues JRA-101 | link JRA-202 Blocks`)\n\n#### Output\n\n* `print` prints formatted output and can display properties (`issues JRA-1 | print $issuetype.name`)\n* `get` has an optional parameter to display the raw field value (`issues JRA-1 | get -r status`)\n* `properties` shows all available properties of the given objects (`projects -p JRA | properties`)\n\n#### Caching\n\nAll requests will be cached in memory during a session, to improve response times and reduce server load.\nUse `cache -c` to clear all current cache entries.\n\n## License\n\nJiracli is licensed under the Apache License, Version 2.0\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpascalgn%2Fjiracli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpascalgn%2Fjiracli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpascalgn%2Fjiracli/lists"}