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

# Organize chats and projects

> Create a project, keep related chats together, and share a brief, brand and files across your work.

Use a chat to work through a request. Use a project to keep related chats, files and finished outputs together.

For example, a launch project might hold one chat for a teaser, another for product images, and a third for social cutdowns. They use the same project folder, brief and brand kit.

You can start with **New chat** without creating a project. Voyager gives that chat its own folder on your first send and lists it under **Recents**.

## Create a project

<Steps>
  <Step title="Open the project dialog">
    In the sidebar, find **Projects** and click **Add project**. You can also use the project chooser above a new chat and select **New project**.
  </Step>

  <Step title="Name the work and choose its folder">
    Fill in **Name**. Use **What are you making?** for a short brief: the outcome, audience, look and anything to avoid.

    Leave **Folder** empty to use the suggested new folder, or choose the folder you want to work in. If you have a brand kit, choose it under **Brand kit**; otherwise you can leave it unset.

    Click **Create**.

    <Frame caption="The name, brief, folder and optional brand kit give the project its starting context.">
      <img className="block dark:hidden" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/first-video-new-project.light.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=264d99ac48d443449a9707ae70bdbe47" alt="The New project dialog with Name, What are you making, Folder and Brand kit fields filled for a launch project." width="992" height="1064" data-path="images/screenshots/first-video-new-project.light.png" />

      <img className="hidden dark:block" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/first-video-new-project.dark.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=25e4341793b2b1e1ceceed3626acac97" alt="The New project dialog with Name, What are you making, Folder and Brand kit fields filled for a launch project." width="992" height="1064" data-path="images/screenshots/first-video-new-project.dark.png" />
    </Frame>
  </Step>

  <Step title="Start the first chat">
    Send a request from the project page's message box. Voyager opens a chat in that project.

    To start another, use the **+** beside the project in the sidebar, or choose the project when starting a new chat. Continue the same chat for revisions to its existing work.
  </Step>
</Steps>

## Give each chat the same brief

Click the project name in the sidebar to open its page. In **Context**, click **Add** or **Edit** and write the information every chat should know.

```text theme={"system"}
We're making a launch campaign for Northwind, a small outdoor brand.
Audience: people planning their first weekend camping trip.
Keep the tone welcoming and practical. Use the project brand kit.
Avoid extreme-sports imagery and unverified product claims.
```

The brief saves automatically. Every new chat in the project starts with it. Keep piece-specific instructions, such as one video's timing, in that chat's request.

<Frame caption="Use Context for the shared brief, and Outputs to return to finished work.">
  <img className="block dark:hidden" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/projects-page.light.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=12547790c4517df39176992d2ba94244" alt="A project page showing Outputs, Conversations, Brand kit, Context, Editor preferences and Storage." width="2880" height="1800" data-path="images/screenshots/projects-page.light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/projects-page.dark.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=2291a2a5fc4ba1550d3e84b75400a284" alt="A project page showing Outputs, Conversations, Brand kit, Context, Editor preferences and Storage." width="2880" height="1800" data-path="images/screenshots/projects-page.dark.png" />
</Frame>

The **Brand kit** card holds the project's visual identity. **Editor preferences** lets you choose apps for this project's work. **Outputs** brings together files the agent has delivered, including their versions.

## Find and organize chats

Click the sidebar's search icon for **Search chats**. Expand a project to see its chats; **Recents** contains chats without a project.

Right-click a chat for its actions:

| Action | When to use it |
| - | - |
| **Pin thread** | Keep a chat easy to reach under **Pinned**. |
| **Rename thread** | Give it a more useful name. |
| **Move to project** | Put the chat into the appropriate project. Choose **No project** to take it out of a project. |
| **Snooze** | Put it aside until the chosen time; look under **Snoozed** to find it. |
| **Archive thread** | Remove it from the sidebar while keeping the chat in **Settings → Archive**. |

<Frame caption="The chat menu includes Move to project when you want to organize work you already started.">
  <img className="block dark:hidden" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/chats-row-menu.light.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=554509392e5d052ce70f2576b85617c7" alt="A chat's right-click menu with Move to project and other organization actions." width="638" height="1800" data-path="images/screenshots/chats-row-menu.light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/chats-row-menu.dark.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=fe2db7207ee97e57242aac18d4c4ffd0" alt="A chat's right-click menu with Move to project and other organization actions." width="638" height="1800" data-path="images/screenshots/chats-row-menu.dark.png" />
</Frame>

## Check the result

Your project should appear in **Projects**, with its chats underneath. Open its page to check the **Context** and delivered **Outputs**. Use **… → Copy folder path** when you need the project folder's location.

## Common problems

<AccordionGroup>
  <Accordion title="My chat is in Recents instead of the project">
    Right-click it, choose **Move to project**, and select the intended project. When starting the next chat, check the project chooser before sending.
  </Accordion>

  <Accordion title="Renaming the project did not rename its folder">
    Renaming changes the project name in Voyager. The folder stays at its existing location. Use **Copy folder path** to find it.
  </Accordion>

  <Accordion title="The output is missing from the project page">
    Ask the agent to present the finished file as an output. **Files** can contain drafts and working files that do not appear in **Outputs**.
  </Accordion>
</AccordionGroup>

<Warning>
  **Remove project**, under **… → Project settings**, deletes the project entry and its chats. It leaves files on disk, but it is not a way to hide a project temporarily. Use **Archive thread** to put individual chats away while keeping their history.
</Warning>

<CardGroup cols={2}>
  <Card title="Write a request" href="/guides/write-a-request">
    Turn the project brief into a concrete first task.
  </Card>

  <Card title="Files and previews" href="/guides/files-and-previews">
    Browse working files and delivered versions.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.