78 lines
3.8 KiB
Markdown
78 lines
3.8 KiB
Markdown
---
|
|
title: Renaming a codespace
|
|
intro: 'You can change the codespace display name to one of your choice through {% data variables.product.prodname_dotcom_the_website %} or the {% data variables.product.prodname_cli %}.'
|
|
versions:
|
|
fpt: '*'
|
|
ghec: '*'
|
|
type: how_to
|
|
topics:
|
|
- Codespaces
|
|
- Fundamentals
|
|
- Developer
|
|
shortTitle: Rename a codespace
|
|
---
|
|
|
|
## About renaming a codespace
|
|
|
|
Each codespace is assigned an auto-generated display name. If you have multiple codespaces, the display name helps you to differentiate between codespaces. For example: `literate space parakeet`. You can change the display name for your codespace.
|
|
|
|
To find the display name of a codespace:
|
|
|
|
- On {% data variables.product.product_name %}, view your list of codespaces at https://github.com/codespaces.
|
|
|
|
|
|
|
|
- In the {% data variables.product.prodname_vscode %} desktop application, or the {% data variables.product.prodname_vscode_shortname %} web client, click the Remote Explorer. The display name is the second item in the list. For example: `symmetrical space telegram` in the screenshot below.
|
|
|
|
|
|
|
|
{% indented_data_reference reusables.codespaces.remote-explorer spaces=2 %}
|
|
- In a terminal window on your local machine, use this {% data variables.product.prodname_cli %} command: `gh codespace list`.
|
|
|
|
### Permanent codespace names
|
|
|
|
In addition to the display name, when you create a codespace, a permanent name is also assigned to the codespace. The name is a combination of your {% data variables.product.company_short %} handle, and the auto-generated display name. For example: `octocat-literate-space-parakeet-mld5`. You can't change the permanent name.
|
|
|
|
To find the permanent name of a codespace:
|
|
|
|
* On {% data variables.product.product_name %}, the permanent name is shown in a pop-up when you hover over the display name of a codespace on https://github.com/codespaces.
|
|
|
|
|
|
|
|
* In a codespace, use this command in the terminal: `echo $CODESPACE_NAME`.
|
|
* In a terminal window on your local machine, use this {% data variables.product.prodname_cli %} command: `gh codespace list`.
|
|
|
|
## Renaming a codespace
|
|
|
|
Changing the display name of a codespace can be useful if you have multiple codespaces that you will be using for an extended period. An appropriate name helps you identify a codespace that you use for a particular purpose.
|
|
|
|
{% cli %}
|
|
|
|
You can change the display name for your codespace by using the {% data variables.product.prodname_cli %}.
|
|
|
|
To rename a codespace, use the `gh codespace edit` subcommand:
|
|
|
|
```shell
|
|
gh codespace edit -c PERMANENT-CODESPACE-NAME -d NEW-DISPLAY-NAME
|
|
```
|
|
|
|
In this example, replace `PERMANENT-CODESPACE-NAME` with the permanent name of the codespace whose display name you want to change. Replace `NEW-DISPLAY-NAME` with the display name you want to use for this codespace.
|
|
|
|
For more information, see "[Using {% data variables.product.prodname_github_codespaces %} with {% data variables.product.prodname_cli %}](/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli#rename-a-codespace)."
|
|
|
|
{% endcli %}
|
|
|
|
{% webui %}
|
|
|
|
You can change the display name for your codespace on {% data variables.product.prodname_dotcom_the_website %}.
|
|
|
|
{% data reusables.codespaces.your-codespaces-procedure-step %}
|
|
|
|
The current display name for each of your codespaces is displayed.
|
|
|
|
{% data reusables.codespaces.ellipsis-settings %}
|
|
1. Click **Rename**.
|
|
|
|
1. In the prompt, under "Change display name to..." type your desired display name and click **OK**.
|
|
|
|
{% endwebui %} |