> ## Documentation Index
> Fetch the complete documentation index at: https://kb.packfiles.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrate a Repository

> Let’s migrate!

### Objective

At last, it’s time to migrate a repository to GitHub! You’ll do this entirely in *Migration HQ*.

**At the end of this section, you will have a repository that has been migrated from its source and into your GitHub organization.**

<Info>
  Search for the 🛠️ emoji if you’d like to skim through this content while focusing on the steps you need to follow.
</Info>

### Select a Repository to Migrate

After scanning your source for repositories, you navigated to *Migration HQ*’s *Issues* page, where you saw the open issues list:

<Frame caption="*Migration HQ*’s *Issues* page, with a close-up view of the open issues list.">
  <img src="https://mintcdn.com/packfiles/l0V83cTRF3ti5K9q/content/media/images/image%20(1)%20(1).png?fit=max&auto=format&n=l0V83cTRF3ti5K9q&q=85&s=153f19ebf9c4c3f41d701fa2f6855da5" alt="Migration HQ’s Issues page, with a close-up view of the open issues list." width="2762" height="974" data-path="content/media/images/image (1) (1).png" />
</Frame>

Each item in the open issues list represents a repository to be migrated. After migrating a repository, Warp automatically closes its issue, which moves it to the closed issues list.

Let’s migrate a repository! For this example, we’ll migrate **TailwindTraders-Website**, whose issue is at the top of the open issues list pictured above.

🛠️ In your open issues list, click on the issue for the repository you want to migrate.

The page for the issue will appear:

<Frame caption="The page for the *TailwindTraders-Website* issue.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(2).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=d338b79558ca60f019ffefd0c53371d0" alt="The page for the TailwindTraders-Website issue." width="3776" height="1898" data-path="content/media/images/image (2).png" />
</Frame>

### Migrate the Repository

🛠️ Scroll to the comments section at the bottom of the issue page:

<Frame caption="The *Add a comment* box at the bottom of the page for the *TailwindTraders-Website* issue.">
  <img src="https://mintcdn.com/packfiles/l0V83cTRF3ti5K9q/content/media/images/image%20(15).png?fit=max&auto=format&n=l0V83cTRF3ti5K9q&q=85&s=94cc2e6c3aafd5b54cb8cc565261e02b" alt="The &#x22;Add a comment&#x22; box at the bottom of the page for the &#x22;TailwindTraders-Website&#x22; issue." width="2072" height="745" data-path="content/media/images/image (15).png" />
</Frame>

You issue commands to Warp in comments by using *slash commands* — commands that begin with the slash (`/`) character. One of these commands is /migrate, which tells Warp to migrate the repository represented by this issue.

🛠️ Enter the slash command `/migrate` into the comment box and click the **Comment** button.

A couple of seconds later, Warp will confirm that it received the command. The comments section will look like this:

<Frame caption="The comments section of the page for the *TailwindTraders-Website* issue.">
  <img src="https://mintcdn.com/packfiles/l0V83cTRF3ti5K9q/content/media/images/image%20(16).png?fit=max&auto=format&n=l0V83cTRF3ti5K9q&q=85&s=8ddee2e94145e45a298be60ccbd8238b" alt="The comments section of the page for the TailwindTraders-Website issue. The first comment, by the user “AccordionGuy”, says “/migrate”. The follow-up comment, by the user “packfiles-warp”, says “@AccordionGuy, your migration’s in progress! We’ll let you know when it’s complete.”" width="2072" height="737" data-path="content/media/images/image (16).png" />
</Frame>

Warp — which will have the user name **packfiles-warp** — always provides a response to your commands as a follow-up comment. In the example above, it’s notifying you that the migration process has begun.

It typically takes a few minutes to perform a migration. Let’s use this time to watch the migration’s progress.

🛠️ Switch to *Migration HQ*’s *Actions* page by clicking the **Actions** tab:

<Frame caption="*Migration HQ*’s *Actions* page.">
  <img src="https://mintcdn.com/packfiles/l0V83cTRF3ti5K9q/content/media/images/image%20(17).png?fit=max&auto=format&n=l0V83cTRF3ti5K9q&q=85&s=a07714fa9329d26ffab497cb9396af64" alt="Migration HQ’s Actions page with a new active Warp Runner Agent. " width="3800" height="1170" data-path="content/media/images/image (17).png" />
</Frame>

You’ll see a new Warp Runner Agent running the workflow that performs the migration:

<Frame>
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(21).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=ac33813022ebb63c4a7f49e7a995b6a1" alt="The Warp Runner Agent, up close." width="375" data-path="content/media/images/image (21).png" />
</Frame>

🛠️ Click on the Runner Agent to get a closer look at what it’s doing.

You’ll see the Runner Agent’s page:

<Frame caption="The Warp Runner Agent’s page.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(19).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=d53d313cd6f71c18fcd7cf195b6746da" alt="The Warp Runner Agent’s page." width="3802" height="1260" data-path="content/media/images/image (19).png" />
</Frame>

Let’s get an even closer look at what the Runner Agent is doing.

🛠️ Click on the job that the Runner Agent is running — it’s any of the objects onscreen labeled **Packfiles Warp Runner Agent** that has a spinning yellow icon beside it:

<Frame>
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(20).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=6557437cdc251b360526aaafc5f4c755" alt="The Warp Runner Agent up close." width="303" data-path="content/media/images/image (20).png" />
</Frame>

You’ll go to a page where you can see the log files that the job is generating in real time:

<Frame caption="The logs for the Warp Runner Agent, while the Agent is running.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(22).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=e48c48c2f59c80e17b1773464e95aa8f" alt="The logs for the Warp Runner Agent." width="3802" height="1890" data-path="content/media/images/image (22).png" />
</Frame>

A couple of minutes later, the migration will be complete. You’ll know this has happened when the Runner Agent’s icon changes from spinning and yellow to a static green checkmark:

<Frame caption="The logs for the Warp Runner Agent, after the Agent has completed its task.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(23).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=daac40938ce75f7d8ba99726e193bc2d" alt="The logs for the Warp Runner Agent, after the Agent has completed its task." width="3804" height="1866" data-path="content/media/images/image (23).png" />
</Frame>

🛠️ Click the **Actions** tab to return to the top level of the *Actions* page.

You’ll see that the Runner Agent completed its tasks:

<Frame caption="*Migration HQ*’s *Actions* page.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(18).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=008be461b57998bc438cc83a86f773ef" alt="Migration HQ’s Actions page after the Warp Runner Agent has completed its task." width="3800" height="1170" data-path="content/media/images/image (18).png" />
</Frame>

### Examine Your Migrated Repository

With the Runner Agent’s tasks complete, your repository has been migrated! Let’s look at its issue.

🛠️ Click the **Issues** tab to view the *Issues* page.

You’ll see something like this:

<Frame caption="*Migration HQ*’s *Issues* page — the open issues.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(24).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=09cfd1645dd59e887caadaaa8c48f2b5" alt="Migration HQ’s &#x22;Issues&#x22; page, with the open issues list displayed. The open issues list displays 4 items." width="3778" height="1145" data-path="content/media/images/image (24).png" />
</Frame>

Notice that:

* There’s one less item in the open issues list, and
* There one new item in the formerly empty closed issues list.

🛠️ Click the **Closed** tab to view the closed issues list.

You’ll see the issue for the newly migrated repository:

<Frame caption="*Migration HQ*’s *Issues* page — the closed issues.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(26).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=dbfdb5df8af39281d522720aa85e9d18" alt="Migration HQ’s &#x22;Issues&#x22; page, with the closed issues list displayed. The closed issues list displays 1 item." width="3778" height="729" data-path="content/media/images/image (26).png" />
</Frame>

🛠️ Click the issue to view its details:

<Frame>
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(27).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=5255ad6edf160d4b446fb80c560b4eda" alt="" width="2751" height="170" data-path="content/media/images/image (27).png" />
</Frame>

You’ll see that the issue has been updated:

<Frame caption="The updated page for the *TailwindTraders-Website* issue.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(28).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=2ffed367b969e4b0069dc215e828a63c" alt="The updated page for the &#x22;TailwindTraders-Website&#x22; issue. Its content now indicates that the repository has been migrated." width="3778" height="1902" data-path="content/media/images/image (28).png" />
</Frame>

🛠️ Scroll to the comments section at the bottom of the page.

You’ll see a new comment from Warp, followed by a new notification:

<Frame caption="The newest comment on the *TailwindTraders-Website* issue page.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(30).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=e56d44efb6e0369ec615d4407eb71ab3" alt="The newest comment on the &#x22;TailwindTraders-Website&#x22; issue page. The comment says &#x22;@AccordionGuy, your migration was successful. Visit your new code’s home at TailwindTraders.TailwindTraders-Website.&#x22;" width="2084" height="565" data-path="content/media/images/image (30).png" />
</Frame>

The comment informs you that the migration was successful and provides a link to the newly migrated repository.

The notification below the comment informs you that Warp automatically closed this issue.

🛠️ Confirm that the migration was successful by clicking the link in the comment. In this example, the link is the text **Tailwind-Traders.TailwindTraders-Website**.

Here’s what the example migrated repository looks like:

<Frame caption="The migrated Tailwind-Traders repository.">
  <img src="https://mintcdn.com/packfiles/Jt8JnIIrXRnRUKLp/content/media/images/image%20(32).png?fit=max&auto=format&n=Jt8JnIIrXRnRUKLp&q=85&s=3c9cfa64a81fdfba1d383baa497d435a" alt="The &#x22;Code&#x22; page for the migrated Tailwind-Traders repository." width="3778" height="1902" data-path="content/media/images/image (32).png" />
</Frame>

<Success>
  🙌 Congratulations — you did it! 🙌

  You successfully migrated a repository!
</Success>
