{"id":14155120,"url":"https://github.com/InditexTech/gh-sherpa","last_synced_at":"2025-08-06T00:33:18.343Z","repository":{"id":213271556,"uuid":"637824878","full_name":"InditexTech/gh-sherpa","owner":"InditexTech","description":"Streamline branch and pull request creation for Jira or GitHub issues from command line","archived":false,"fork":false,"pushed_at":"2024-05-28T15:52:29.000Z","size":229,"stargazers_count":47,"open_issues_count":16,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-05-29T05:19:18.532Z","etag":null,"topics":["command-line","contributing","gh-extension","golang","inditex","sherpa"],"latest_commit_sha":null,"homepage":"","language":"Go","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/InditexTech.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-08T13:41:16.000Z","updated_at":"2024-06-03T15:11:34.200Z","dependencies_parsed_at":"2023-12-19T14:22:47.915Z","dependency_job_id":"66df1e9f-091f-4a26-a3e4-3b1a98f50d12","html_url":"https://github.com/InditexTech/gh-sherpa","commit_stats":null,"previous_names":["inditextech/gh-sherpa"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/InditexTech%2Fgh-sherpa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/InditexTech%2Fgh-sherpa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/InditexTech%2Fgh-sherpa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/InditexTech%2Fgh-sherpa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/InditexTech","download_url":"https://codeload.github.com/InditexTech/gh-sherpa/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228821396,"owners_count":17977164,"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":["command-line","contributing","gh-extension","golang","inditex","sherpa"],"created_at":"2024-08-17T08:02:04.984Z","updated_at":"2025-08-06T00:33:18.311Z","avatar_url":"https://github.com/InditexTech.png","language":"Go","funding_links":[],"categories":["Go","🧩 Categories","golang","PR \u0026 Issues"],"sub_categories":["Repository Management"],"readme":"[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=InditexTech_gh-sherpa\u0026metric=bugs)](https://sonarcloud.io/summary/new_code?id=InditexTech_gh-sherpa)\n[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=InditexTech_gh-sherpa\u0026metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=InditexTech_gh-sherpa)[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=InditexTech_gh-sherpa\u0026metric=reliability_rating)](https://sonarcloud.io/summary/new_code?id=InditexTech_gh-sherpa)\n\n# Sherpa extension for GitHub CLI\n\nSherpa for [GitHub CLI](https://github.com/cli/cli) makes it easy for you to **create branches** and **pull requests**\nassociated with any **GitHub or Jira issue**.\n\nThis extension retrieves the type of issue (_User Story_, _Bug_, _Technical Improvement_, etc) and creates a branch or\npull request associated with that issue, following the contribution model you define in a\n[configuration file](#configuration).\n\n![Create PR](docs/images/create-pr.svg)\n\n## Table of contents\n\n- [Prerequisites](#prerequisites)\n- [Installation](#installation)\n- [Configuration](#configuration)\n- [Usage](#usage)\n- [Contribute](#contribute)\n\n## Prerequisites\n\n- An available GitHub account.\n- [**GitHub CLI**](https://github.com/cli/cli) (version `2.0.0` or higher) configured and\n[authenticated](https://cli.github.com/manual/gh_auth_login) in your development environment.\n- **Bash**: Supports Linux, MacOS and Windows (for the latter, we recommend using\n[`WSL2`](https://learn.microsoft.com/en-us/windows/wsl/install)).\n\n## Installation\n\nMake sure you meet the [prerequisites](#prerequisites) first.\n\nYou can **install** this extension just running this command from your terminal:\n\n```sh\ngh extension install InditexTech/gh-sherpa\n```\n\n### Upgrade\n\nIf you have already installed this extension and you want to **upgrade** it, so, you should run this command from your\nterminal:\n\n```sh\ngh extension upgrade sherpa\n```\n\n### Remove\n\nTo **remove** this extension just run:\n\n```sh\ngh extension remove sherpa\n```\n\n## Configuration\n\nSherpa uses different issue types (`feature`, `bugfix`, `hotfix`, `refactoring`, etc) when mapping an issue with its\ncorresponding branch prefix.\n\n### Default configuration\n\nBy default, it will use the [`internal/config/default-config.yml`](internal/config/default-config.yml) configuration\nfile to perform these mappings.\n\n### Custom configuration\n\nOtherwise, if you wish customize the different issue types, branch prefixes, etc, so, you can **create your own\nconfiguration file** located in `$HOME/.config/sherpa/config.yml` from the\n[default config file](internal/config/default-config.yml).\n\n\u003e If you are **using Jira as issue tracker**, so, the first time you run a command it will ask you to configure Jira\ncredentials and then proceed to create the custom configuration file with the provided Jira credentials.\n\n## Usage\n\nAfter installing this extension in your development environment, you can know the available commands in the\n[`USAGE.md`](docs/USAGE.md) file.\n\n## Contribute\n\nBefore developing any new feature or fix, please, check the [`CONTRIBUTING.md`](CONTRIBUTING.md) file. You will find\nthere the steps to contribute along with development and testing guidelines.\n\n## Security\n\nIf you find a security vulnerability in this project, please, check the [`SECURITY.md`](SECURITY.md) file to know how to\nreport it.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FInditexTech%2Fgh-sherpa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FInditexTech%2Fgh-sherpa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FInditexTech%2Fgh-sherpa/lists"}