# BRANCH RENAME

> Rename branches with the Unity Version Control CLI.

## Description

Renames a branch.

### Usage

```bash
cm branch | br rename <brspec> <new_name>
```

| Option / Argument | Description                                                                                |
| :---------------- | :----------------------------------------------------------------------------------------- |
| brspec            | Branch to rename. (Use '**cm** **help** **objectspec**' to learn more about branch specs.) |
| new\_name         | New name for the branch.                                                                   |

## Help

### Remarks

This command renames a branch.

### Examples

```bash
cm branch rename /main/task0 task1
```

(Renames branch '/main/task0' to '/main/task1'.)

```bash
cm br rename br:/main@reptest@server2:8084 secondary
```

(Renames the 'main' branch of repository 'reptest' to 'secondary'.)