@broadcom/endevor-bridge-for-git-for-zowe-cli/README.md

Endevor Bridge for Git plug-in for Zowe CLI

# Endevor Bridge for Git for Zowe CLI

The Endevor Bridge for Git Plug-in for Zowe CLI allows you to work with and manage Git-Endevor mappings of your Bridge for Git server. Also, as a developer, you can build the changed files from the local working directory of your mapping in an Endevor work area.

## Use Cases

As an application developer, you can use the plug-in to perform the following tasks:

- Build working directory changes of a Git-Endevor mapping in Endevor. (`@zowe-v1-lts`, `@zowe-v2-lts`, `@zowe-v3-lts`, `@latest`)
- Manage Git-Endevor mappings from the CLI. (`@zowe-v2-lts`, `@zowe-v3-lts`, `@latest`)
- Enables you to create the same kind of Git-Endevor mappings that are supported in the application. You can also manage the branches of existing mappings.
- Manage mainframe credentials for Git-Endevor mappings. (`@zowe-v2-lts`, `@zowe-v3-lts`, `@latest`)

## Software Requirements

Before you use the plug-in, ensure that you meet the following prerequisites:

- Zowe CLI v6.17.3 or higher
- Endevor Plug-in for Zowe CLI v6.4.0 or higher

For use with Zowe V2, ensure that you meet the following prerequisites

- Zowe CLI v7.0.0 or higher
- Endevor Plug-in for Zowe CLI 7.0.1 or higher

For use with Zowe V3, ensure that you meet the following prerequisites

- Zowe CLI v8.0.0 or higher

## Install the Endevor Bridge for Git Plug-in for Zowe CLI

The Endevor Bridge for Git Plug-in for Zowe CLI is associated with the following tags:

`@latest`

`@zowe-v3-lts`

`@zowe-v2-lts`

`@zowe-v1-lts`

The version with the `@latest` tag is actively updated with new features and functionality.

The `@zowe-v3-lts` tag represents the V3 stable version of the plug-in which conforms to the Zowe V3 Conformance criteria, including the team configuration support.

The `@zowe-v2-lts` tag represents the V2 stable version of the plug-in which conforms to the Zowe V2 Conformance criteria, including the team configuration support.

The `@zowe-v1-lts` tag represents the V1 stable version of the plug-in which might not include all the newest functionality.

To install the active version of the plug-in, issue the following command:

```
zowe plugins install @broadcom/endevor-bridge-for-git-for-zowe-cli@latest
```

To install the V3 stable version of the plug-in, issue the following command:

```
zowe plugins install @broadcom/endevor-bridge-for-git-for-zowe-cli@zowe-v3-lts
```

To install the V2 stable version of the plug-in, issue the following command:

```
zowe plugins install @broadcom/endevor-bridge-for-git-for-zowe-cli@zowe-v2-lts
```

To install the stable version of the plug-in, issue the following command:

```
zowe plugins install @broadcom/endevor-bridge-for-git-for-zowe-cli@zowe-v1-lts
```