> For the complete documentation index, see [llms.txt](https://docs.qyrus.com/device-farm/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qyrus.com/device-farm/ai-session/manage-projects-and-tests.md).

# Manage Projects and Tests

Projects group reusable AI journeys, app builds, devices, tests, and reports by product or workflow.

## Create a Project

1. Open **Projects** in Device Farm.
2. Select **Create Project**.
3. Choose a project icon.
4. Enter a **Project name**.
5. Enter a **Project goal** describing the journeys, apps, or devices the project should cover.
6. Select **Create Project**.

The project appears in the Projects list after it is created.

<div align="center"><img src="https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-7d90a02738cdbe095fdb547de423dde0b8e5159d%2Fcreate-project.png?alt=media" alt="Create project"></div>

## Open and Manage a Project

The Projects page provides a project search field and Grid/List view controls. Each project card can show its name, status, goal, progress, and last-updated date. Open a project card to manage its tests, devices, apps, and integrations. Project cards also provide an actions menu for project-level actions.

The Projects page lists the available projects and provides the entry point for opening a project. No separate project-list capture is required for the current guide.

## Save a Session as a Project Test

1. Complete an AI Session.
2. Select **Save** from the session workspace.
3. Choose an existing project or create a new project.
4. Enter the test name and continue.
5. Review the device and app options.
6. Select **Save**.

When the session is saved, the test appears in the project's **Tests** tab. The device and app can be copied with the test when their corresponding project options are enabled. After saving, open the test’s **Steps** tab to review actions and optionally add a **Nudge** for a step that may vary during a future rerun. Nudges are available whether or not Record for Automation was used during the original session.

## Upload an App to a Project

Open the project's **Apps** tab and select **Add App**. The complete upload flow is documented in [Upload an App to a Session](/device-farm/ai-session/upload-an-app.md).

## Start a Session from a Project

1. Open the project.
2. Select **Start Session**.
3. Choose the platform and real device.
4. Select an app from **App to test** when required.
5. Enter the session goal.
6. Start the session.

Starting from the project provides the project context and makes apps associated with that project available in the session app selector.

![Start session from project](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-44ee74180e202f7fd4dcaba41521c2da309dd3f0%2Fstart-session-from-project.png?alt=media)