{"id":28905625,"url":"https://github.com/asim-tahir/azure-devops.fish","last_synced_at":"2026-04-12T23:43:14.240Z","repository":{"id":293086130,"uuid":"932028089","full_name":"Asim-Tahir/azure-devops.fish","owner":"Asim-Tahir","description":"Azure DevOps plugin for Fish shell","archived":false,"fork":false,"pushed_at":"2025-06-12T11:14:57.000Z","size":13,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-21T13:39:19.371Z","etag":null,"topics":["azure","azure-devops","fish","fish-plugin","fish-shell","fisher","oh-my-fish","oh-my-fish-plugin","pull-requests"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Asim-Tahir.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-13T08:47:26.000Z","updated_at":"2025-06-12T11:15:00.000Z","dependencies_parsed_at":"2025-06-29T03:32:52.039Z","dependency_job_id":null,"html_url":"https://github.com/Asim-Tahir/azure-devops.fish","commit_stats":null,"previous_names":["asim-tahir/azure-devops.fish"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Asim-Tahir/azure-devops.fish","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asim-Tahir%2Fazure-devops.fish","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asim-Tahir%2Fazure-devops.fish/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asim-Tahir%2Fazure-devops.fish/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asim-Tahir%2Fazure-devops.fish/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Asim-Tahir","download_url":"https://codeload.github.com/Asim-Tahir/azure-devops.fish/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asim-Tahir%2Fazure-devops.fish/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279491817,"owners_count":26179476,"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","status":"online","status_checked_at":"2025-10-18T02:00:06.492Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["azure","azure-devops","fish","fish-plugin","fish-shell","fisher","oh-my-fish","oh-my-fish-plugin","pull-requests"],"created_at":"2025-06-21T13:31:06.524Z","updated_at":"2025-10-18T08:13:55.617Z","avatar_url":"https://github.com/Asim-Tahir.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://cdn.rawgit.com/oh-my-fish/oh-my-fish/e4f1c2e0219a17e2c748b824004c8d0b38055c16/docs/logo.svg\" align=\"left\" width=\"192px\" height=\"192px\"/\u003e\n\u003cimg align=\"left\" width=\"0\" height=\"192px\" hspace=\"10\"/\u003e\n\n### `azure-devops.fish`\n\n\u003e `Azure DevOps` plugin for [Oh My Fish][omf] and [Fisher][fisher],\n\n[![MIT License](https://img.shields.io/badge/license-MIT-007EC7.svg?style=flat-square)](/LICENSE)\n[![Fish Shell v3.6.0](https://img.shields.io/badge/fish-v3.6.0-007EC7.svg?style=flat-square)](https://fishshell.com)\n[![Oh My Fish Framework](https://img.shields.io/badge/Oh%20My%20Fish-Framework-007EC7.svg?style=flat-square)][omf]\n\n\u003cbr/\u003e\u003cbr/\u003e\n\n## Install\n\n[Oh My Fish][omf]:\n\n```sh\nomf install https://github.com/Asim-Tahir/azure-devops.fish\n```\n\n[Fisher][fisher]:\n\n```sh\nfisher install Asim-Tahir/azure-devops.fish\n```\n\n## Usage\n\nAfter installing the [`azure-devops.fish`][repo] plugin, can use the functions with the following command:\n\n### Get Azure DevOps Pull Request URL\n\n#### Basic Usage\n\nThe `azure-devops.pr-url` function helps you quickly get the URL of your Azure DevOps pull request. It works in any git repository connected to Azure DevOps.\n\n```fish\nazure-devops.pr-url\n# Output: https://dev.azure.com/organization/project/_git/repository/pullrequestcreate?sourceRef=feature-branch\u0026targetRef=main\n```\n\n#### Arguments\n\n##### Help (`-h`, `--help`)\nDisplay help information:\n\n```fish\nazure-devops.pr-url --help\n# or\nazure-devops.pr-url -h\n```\n\n##### Git Remote Name (`-r`, `--git-remote`)\n\nSpecify the Git remote name:\n\n```fish\nazure-devops.pr-url --git-remote \"upstream\"\n# or\nazure-devops.pr-url -r \"origin\"\n```\n\nDefault: `$AZURE_DEVOPS_FISH_GIT_REMOTE` or \"origin\"\n\n\n##### Git Remote URL (`-R`, `--git-remote-url`)\nProvide the Azure DevOps repository URL directly:\n\n```fish\nazure-devops.pr-url --git-remote-url \"https://dev.azure.com/MyOrg/MyProject/_git/MyRepo\"\n# or\nazure-devops.pr-url -R \"git@ssh.dev.azure.com:v3/MyOrg/MyProject/MyRepo\"\n```\n\nDefault: `$AZURE_DEVOPS_FISH_GIT_REMOTE_URL` or URL from specified git remote\n\n##### Source Branch (`-s`, `--source-branch`)\nSet the source branch for the PR:\n```fish\nazure-devops.pr-url --source-branch \"feature/new-feature\"\n# or\nazure-devops.pr-url -s \"bugfix/issue-123\"\n```\n\nDefault: `$AZURE_DEVOPS_FISH_SOURCE_BRANCH` or current branch\n\n##### Target Branch (`-t`, `--target-branch`)\n\nSet the target branch for the PR:\n\n```fish\nazure-devops.pr-url --target-branch \"main\"\n# or\nazure-devops.pr-url -t \"develop\"\n```\n\nDefault: `$AZURE_DEVOPS_FISH_TARGET_BRANCH` or git default branch\n\n#### Example Usage\n\n1. Basic usage with default values:\n```fish\nazure-devops.pr-url\n```\n\n2. Specify target branch only:\n```fish\nazure-devops.pr-url -t \"main\"\n```\n\n3. Custom source and target branches:\n```fish\nazure-devops.pr-url -s \"feature/my-awesome-feature\" -t \"develop\"\n```\n\n4. Using different git remote with target branch:\n```fish\nazure-devops.pr-url -r \"upstream\" -t \"main\"\n```\n\n5. Full example with all arguments:\n```fish\nazure-devops.pr-url \\\n    -s \"feature/my-awesome-feature\" \\\n    -t \"main\" \\\n    -R \"https://My_Org@dev.azure.com/My_Org/My%20-%20Project/_git/My.Repo\"\n```\n\n### Get Azure DevOps Work Item URL\n\nThe `azure-devops.workitem-url` function returns the direct URL to a specific Azure DevOps work item.\n\n#### Basic Usage\n\n```fish\nazure-devops.workitem-url -o \"MyOrganization\" -p \"MyProject\" -w 12345\n# Output: https://dev.azure.com/MyOrganization/MyProject/_workitems/edit/12345\n```\n\n#### Arguments\n\n- `-h`, `--help`           Show help message\n- `-o`, `--organization`   Azure DevOps organization name (required)\n- `-p`, `--project`        Azure DevOps project name (required)\n- `-w`, `--workitem`       Azure DevOps work item ID (required, positive integer)\n\n#### Example\n\n```fish\nazure-devops.workitem-url -o \"MyOrganization\" -p \"MyProject\" -w 12345\n```\n\nIf you have set the following environment variables, you can omit the arguments:\n- `AZURE_DEVOPS_FISH_ORGANIZATION`\n- `AZURE_DEVOPS_FISH_PROJECT`\n- `AZURE_DEVOPS_FISH_WORKITEM`\n\n```fish\nset -x AZURE_DEVOPS_FISH_ORGANIZATION \"MyOrganization\"\nset -x AZURE_DEVOPS_FISH_PROJECT \"MyProject\"\nset -x AZURE_DEVOPS_FISH_WORKITEM 12345\nazure-devops.workitem-url\n```\n\nIf any required argument is missing or invalid, the function will print an error and usage example.\n\n### Environment Variables\n\n#### Input Enviroment Variables\n\n- `AZURE_DEVOPS_FISH_GIT_REMOTE`: Git remote name\n- `AZURE_DEVOPS_FISH_GIT_REMOTE_URL`: Git remote URL\n- `AZURE_DEVOPS_FISH_SOURCE_BRANCH`: Source branch\n- `AZURE_DEVOPS_FISH_TARGET_BRANCH`: Target branch\n\n- `AZURE_DEVOPS_FISH_ORGANIZATION`: Azure DevOps organization name\n- `AZURE_DEVOPS_FISH_PROJECT`: Azure DevOps project name\n- `AZURE_DEVOPS_FISH_WORKITEM`: Azure DevOps work item ID\n\n#### Output Environment Variables\n\n- `AZURE_DEVOPS_FISH_PULL_REQUEST_URL`: Azure DevOps Pull Request URL\n- `AZURE_DEVOPS_FISH_WORKITEM_URL`: Azure DevOps Work Item URL\n\n# Credit\n\nBase structure heavily inspired from [`jhillyerd/plugin-git`](https://github.com/jhillyerd/plugin-git). Thanks for the amazing plugin.\n\n# License\n\n[MIT][license] © [Asim Tahir][author]\n\n[author]: https://github.com/Asim-Tahir\n[repo]: https://github.com/Asim-Tahir/azure-devops.fish\n[license]: https://opensource.org/licenses/MIT\n[omz]: https://github.com/ohmyzsh/ohmyzsh\n[omf]: https://github.com/oh-my-fish/oh-my-fish\n[fisher]: https://github.com/jorgebucaran/fisher\n[license-badge]: https://img.shields.io/badge/license-MIT-007EC7.svg?style=flat-square\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasim-tahir%2Fazure-devops.fish","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasim-tahir%2Fazure-devops.fish","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasim-tahir%2Fazure-devops.fish/lists"}