Renaming a codespace

You can change the codespace display name to one of your choice on GitHub or using the GitHub CLI.

Tool navigation

In this article

About renaming a codespace

When you create a codespace it's 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 GitHub, view your list of codespaces at https://github.com/codespaces.

    Screenshot of a list of three codespaces on the https://github.com/codespaces page."

  • In the Visual Studio Code desktop application, or the VS Code web client, click the Remote Explorer. The display name is the second item in the list. For example: psychic chainsaw in the screenshot below.

    Screenshot of the "Remote Explorer" in VS Code. The codespace display name, "psychic chainsaw," is highlighted with a dark orange outline.

    Note

    If the Remote Explorer is not displayed in the Activity Bar:

    1. Access the Command Palette. For example, by pressing Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux).
    2. Type: details.
    3. Click Codespaces: Details.

  • In a terminal window on your local machine, use this GitHub CLI command: gh codespace list.

Permanent codespace names