{"id":13760381,"url":"https://github.com/rwstauner/jirazzz","last_synced_at":"2025-09-11T01:05:30.215Z","repository":{"id":42200053,"uuid":"378288254","full_name":"rwstauner/jirazzz","owner":"rwstauner","description":"A jira rest client for the command line, written in clojure as a babashka script.","archived":false,"fork":false,"pushed_at":"2022-08-08T20:23:10.000Z","size":87,"stargazers_count":35,"open_issues_count":2,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-06T18:17:52.699Z","etag":null,"topics":["babashka","cli","clojure","jira"],"latest_commit_sha":null,"homepage":"","language":"Clojure","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rwstauner.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":"2021-06-18T23:56:33.000Z","updated_at":"2025-02-23T13:33:43.000Z","dependencies_parsed_at":"2022-08-28T23:03:03.546Z","dependency_job_id":null,"html_url":"https://github.com/rwstauner/jirazzz","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rwstauner%2Fjirazzz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rwstauner%2Fjirazzz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rwstauner%2Fjirazzz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rwstauner%2Fjirazzz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rwstauner","download_url":"https://codeload.github.com/rwstauner/jirazzz/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248840626,"owners_count":21170028,"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":["babashka","cli","clojure","jira"],"created_at":"2024-08-03T13:01:09.058Z","updated_at":"2025-04-14T07:37:58.087Z","avatar_url":"https://github.com/rwstauner.png","language":"Clojure","funding_links":[],"categories":["Clojure"],"sub_categories":[],"readme":"# jirazzz\n\nA jira rest client command line app written as a [babashka][babashka] script.\n\nDesigned for configurability, to be usable with any jira instance.\n\n## Authentication\n\n### OAuth token\n\nJira Cloud: Go to https://id.atlassian.com/manage/api-tokens and create a new token. Then put its base64-encoded value in the config (see below).\n\n### Cookie\n\nMaybe you can't configure cli authentication, or don't want to use basic auth...\nJust visit jira in your browser and steal\nyour own cookie (see \"Example Config\" below).\n\n## Installation\n\nInstall Babashka. Then, Inside a directory that is on your path, such as `/usr/local/bin`:\n\n```\nwget https://raw.githubusercontent.com/rwstauner/jirazzz/main/jirazzz\nchmod u+x jirazzz\nwget https://raw.githubusercontent.com/rwstauner/jirazzz/main/example-config.edn -O ~/.jirazzz.edn\n```\n\nFinally, adjust `~/.jirazzz.edn` as necessary.\n\n## Usage\n\n    jirazzz --help\n\n\u003c!-- { jirazzz help --\u003e\n\n    Usage: jirazzz command [options]\n\n    Commands:\n\n      assign        Set assignee on issue: jirazzz assign --issue ABC-123 username\n      comment       Add comment to issue: jirazzz comment --issue ABC-123 --comment 'Something to say'\n      commit-msg    Create issue from commit msg if no reference exists\n      create        Create issue: jirazzz create --summary … --description …\n      example-alias Custom alias command\n      issue         Get issue: jirazzz issue KEY\n      mine          List open issues assigned to me\n      parse-log     Parse commit log and transition referenced issues\n      search        Search issues: jirazzz search \"some jql fragment\"\n      transition    Transition issue: jirazzz transition --issue ABC-123 --transition 'done'\n      get           Send GET    request: jirazzz get    /rest/api/x/y/z …\n      post          Send POST   request: jirazzz post   /rest/api/x/y/z …\n      put           Send PUT    request: jirazzz put    /rest/api/x/y/z …\n      delete        Send DELETE request: jirazzz delete /rest/api/x/y/z …\n\n    Options can be specified on the command line or in example-config.edn\n    Any aliases defined in {:custom-fields {:your-name :customfield_00000}}\n    can also be set in the config file or on the command line (see below).\n\n    Options:\n      -h, --help                      Show usage\n          --assignee USERNAME         Assign issue to username (-1 for unassigned)\n          --backlog                   Put isue in backlog instead of current sprint\n          --comment BODY              Comment body to add to issue\n          --commit-template TEMPLATE  Selmer template for adding issue to commit message\n          --description DESC          Issue description\n      -i, --issue KEY                 Issue Key\n          --issue-pattern PATTERN     Regular Expression to find issue in commit message\n          --issue-type TYPE           Issue Type\n          --jql SEARCH                JQL fragment used for search\n      -p, --project PROJECT           Project for issue creation\n          --rapid-view ID             RapidView id\n          --sprint-pattern PATTERN    Regular Expression to find current sprint\n          --summary SUMMARY           Issue summary\n          --transition NAME           Transition issue to this state\n          --unassigned                Set issue as Unassigned\n          --url URL                   Jira URL\n          --input-format FORMAT       Set input format (can be 'json', default is 'edn')\n          --output-format FORMAT      Set output format (can be 'json', default is 'edn')\n          --sprint-id VALUE           Set custom field for sprint-id (customfield_12345)\n          --storypoints VALUE         Set custom field for storypoints (customfield_10001)\n\n\n\u003c!-- jirazzz help } --\u003e\n\n\n## Configuration\n\nThe default file is `~/.jirazzz.edn`.\nAn alternate can be specified with env var `JIRAZZZ_CONFIG_FILE`.\n\n\u003c!-- { jirazzz example-config --\u003e\n\n```clojure\n{\n ; URL prefix of your jira instance.\n :url \"https://jira.example.com\"\n ; Any headers you want to add to requests (useful for auth).\n :headers {\"Cookie\" #file \".cookie.txt\"}\n ; or, with an oauth token:\n ;:headers {\"Authorization\" \"Basic \u003cbase64-encoded-token-value\u003e\"}\n ; The rapid-view / sprint board id.\n :rapid-view 123\n ; Project key.\n :project \"ABC\"\n ; Jira username (might be something like \"flastname\").\n :assignee #env USER\n ; Type of issue to create.\n :issue-type \"Task\"\n ; Pattern to look for in commit messages.  Should have single capture group.\n :issue-pattern \"\\\\[([A-Z]+-[0-9]+)\\\\]\"\n ; A selmer template for how to add issue to commit messages.\n :commit-template \"[{{issue}}] {{summary}}\\n\\n{{description}}\"\n ; Transition issue to this state.\n :transition \"ready for review\"\n ; Pattern to match against sprint names when looking for current (first ACTIVE) sprint.\n :sprint-pattern \".\"\n ; Values for defined custom fields.\n :storypoints 1\n ; Aliases for custom fields so they are recognized by config/arguments.\n :custom-fields\n {\n  ; Sprint-id will be filled in with \"current sprint\".\n  :sprint-id   :customfield_12345\n  ; Other fields can be specified on the command line or in config.\n  :storypoints :customfield_10001\n }\n :aliases\n {example-alias {:doc \"Custom alias command\"\n                 :args [\"search\" \"--jql\" \"project = ABC AND statusCategory IN (…)\"]}}\n}\n```\n\n\u003c!-- jirazzz example-config } --\u003e\n\nMost fields in the config file can be overridden via command line arguments\n(see usage output).\n\nAvailable readers:\n- `#env` - Substitute an environment variable\n- `#file` - Read file (relative to config file directory)\n\nNeed to figure out your custom fields?\n\nLook at the json output for an existing issue\nby inspecting the response in your browser, or use jirazzz:\n\n    jirazzz issue ABC-123\n\n\n## Pronunciation\n\nIt's a combination of \"jira\" and \"💤\" (it's a \"rest\" client).\nI call it \"jira Z's\".\n\n## Development\n\nTry `bb tasks` to see a list of babashka tasks useful for development:\n\n\u003c!-- { jirazzz bb tasks --\u003e\n\n    The following tasks are available:\n\n    docs        Regenerate docs\n    lint\n    nrepl       Start nrepl server for editor integration\n    pre-commit  A git pre-commit hook to check docs, style, etc\n    server      Run fake http server for manual testing\n    style:check\n    style:fix\n    test        Run test suite with fake http server\n\n\n\u003c!-- jirazzz bb tasks } --\u003e\n\n\n\n## License\n\nCopyright © 2021 Randy Stauner\n\nDistributed under the Eclipse Public License version 1.0.\n\n\n[babashka]: https://babashka.org\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frwstauner%2Fjirazzz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frwstauner%2Fjirazzz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frwstauner%2Fjirazzz/lists"}