# Warpspaces

### Overview

Before we talk about Warpspaces, let’s review GitHub Codespaces. A Codespace is a fully configured development environment that runs in the cloud, accessible via a web browser or VS Code, and hosted by GitHub. Every Codespace comes with common tools such as git, Python, Node.js, and other programming languages pre-installed. Codespaces can also be customized with other packages.

Warpspaces are Codespaces that have been customized with useful tools for performing migrations, including:

* GitHub’s CLI tools
* GitHub’s migration tools
* Warp’s CLI tools

With a Warpspace, you get a secure, controlled Codespace environment with all the tools you would need to manually run migration tools, perform a manual migration, or manage an edge case where Warp alone will not handle your migration.

### Opening a Warpspace

<figure><img src="/files/UvB2oPFTDZF5U1VUhndH" alt=""><figcaption></figcaption></figure>

To open a Warpspace for a Project:

* Open the Project’s *Migration HQ* repository,
* Click the **Code** button,
* Select the **Codespaces** tab, and
* Click the **+** button or, if it’s available, the **Create codespace on main** button.

<figure><img src="/files/sJCC2Ul2tL8nTrmdw8xK" alt=""><figcaption><p>The Warpspace during the initialization process.</p></figcaption></figure>

The Warpspace will take a couple of minutes to initialize, since it has to import a large set of packages. Once initialized, you’ll be in GitHub’s Codespace environment with a complete set of command-line migration tools and utilities:

<figure><img src="/files/yXduzxMShJXNwP18IcHN" alt=""><figcaption><p>The Warpspace after initialization.</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.packfiles.io/using-warp/migration-hq/warpspaces.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.