# Projects

### What is a Project?

Warp organizes migrations into ***Projects***. In Warp, a Project is an object for managing a *migration engagement* — that is, an event where you will be migrating repositories to GitHub. Projects allow you to view and manage a set of migrations as a distinct operation with its own team, timeline, and budget.

Projects are one of Warp’s ways to make migrations more manageable:

* If you have a small collection of repositories to migrate, you might choose to perform their migrations in a single engagement and use a single project. 
* If you are performing migrations for multiple clients, you might choose to use one project for each client.
* If you’re working with an organization with a large number of repositories to migrate — numbering in the thousands, tens of thousands, or even more — you’ll probably want to divide that task into multiple projects carried out over a period of time.

### The *Projects* Page

When you sign into Warp, you are taken to the *Projects* page, which contains the following:

* **Projects:** The list of active migration engagements, a.k.a. Projects.
* **Pending Installations:** If you have any projects that have not yet been fully set up and configured, they will appear in this list.
* ***Create a New Project***** button:** Starts the process of creating a new project.

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

### The *Projects* List

For every active Project, the list contains an item that looks like this:

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

Each item has the following elements:

* The Project’s name.
* These buttons:
  * <img src="/files/kk8E2m1s9moKzjhgETLv" alt="" data-size="line"> : **Settings.** View and manage the Project’s settings.
  * <img src="/files/GzSuBtb1IWXi5XCZSeCF" alt="" data-size="line"> : ***Migration HQ.*** View *Migration HQ*, the GitHub repository where you manage the migration process.
  * <img src="/files/mNV01HixpUSIyKhIuaK2" alt="" data-size="line"> : **Dashboard.** See a high-level overview of the Project.

### The *Pending Installations* List

For every Project that has been created but not yet set up and configured, the list that contains an item that looks like this:

<figure><img src="/files/4awWO3kdolubGMECqgTM" alt=""><figcaption></figcaption></figure>

Each item has the following elements:

* The Project’s name.
* The **Start Installation** button, which starts the process of setting up and configuring the Project for use.


---

# 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/projects.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.