1
0
mirror of synced 2025-12-21 10:57:10 -05:00
Files
docs/content/codespaces/developing-in-codespaces/deleting-a-codespace.md

3.2 KiB

title, intro, product, redirect_from, versions, type, topics, shortTitle
title intro product redirect_from versions type topics shortTitle
Deleting a codespace You can delete a codespace you no longer need. {% data reusables.gated-features.codespaces %}
/github/developing-online-with-github-codespaces/deleting-a-codespace
/github/developing-online-with-codespaces/deleting-a-codespace
fpt ghec
* *
how_to
Codespaces
Fundamentals
Developer
Delete a codespace

{% data reusables.codespaces.concurrent-codespace-limit %}

{% note %}

Note: Only the person who created a codespace can delete it. There is currently no way for organization owners to delete codespaces created within their organization.

{% endnote %}

Deleting a codespace

{% webui %}

  1. Navigate to the "Your Codespaces" page at github.com/codespaces.

  2. To the right of the codespace you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click {% octicon "trash" aria-label="The trash icon" %} Delete

    Delete button

{% endwebui %}

{% vscode %}

{% data reusables.codespaces.deleting-a-codespace-in-vscode %}

{% endvscode %}

{% cli %}

{% data reusables.cli.cli-learn-more %}

To delete a codespace use the gh codespace delete subcommand and then choose a codespace from the list that's displayed.

gh codespace delete

If you have unsaved changes, you'll be prompted to confirm deletion. You can use the --force flag to force deletion, avoiding this prompt.

For more information about this command, see the {% data variables.product.prodname_cli %} manual.

{% endcli %}

Bulk deleting codespaces

{% webui %}

You can use {% data variables.product.prodname_cli %} to delete several or all of your codespaces with a single command. For more information, click the {% data variables.product.prodname_cli %} tab near the top of this page.

{% endwebui %}

{% vscode %}

You can use {% data variables.product.prodname_cli %} to delete several or all of your codespaces with a single command. For more information, click the {% data variables.product.prodname_cli %} tab near the top of this page.

{% endvscode %}

{% cli %}

You can delete several or all of your codespaces with a single command, using gh codespace delete followed by one of these flags:

--all - Delete all of your codespaces.

--repo REPOSITORY - Delete all of your codespaces for this repository. Or use together with the --days flag to filter by age of the codespace.

--days NUMBER - Delete all of your codespaces that are older than the specified number of days. Can be used together with the --repo flag.

By default you are prompted to confirm deletion of any codespaces that contain unsaved changes. You can use the --force flag to skip this confirmation.

Example

Delete all of the codespaces for the octo-org/octo-repo repository that you created more than 7 days ago.

gh cs delete --repo octo-org/octo-repo --days 7

{% endcli %}

Further reading