# Projects

Organize your work into focused Projects where Korey can plan, execute, and track progress alongside you.

This is a beta experience. If your team wants access to the beta, reach out to us at [support@korey.ai](mailto:support@korey.ai).

**Projects** give you a dedicated space to plan and execute on a focused area of work, with a living Spec, a Project-scoped chat, and a real-time view of triaged tasks handed off to your team of agents.

## Create a Project

Start a new Project a few ways:

- **From the Projects page:** open **Projects** in the left navigation and create a new Project directly from there.
- **From the chat button drop-down:** Switch from "Chat" to "Project" to turn any chat into a Project. The button is in the top right corner of any existing chat.
- **Directly in chat:** ask Korey to create a Project or spec an idea for you in any chat. Try, "Start a Project and spec out [idea]" and Korey will suggest creating a Project.

## The Project view

Every Project opens into a three-panel view:

- **Spec:** a freeform, editable document that serves as your source of truth. Korey references the Spec when executing work.
- **Chat:** a Project-scoped chat with full context of your Spec and Execute column. Use it to refine the plan, give direction, or ask Korey questions about the work.
- **Execute column:** Stories and Sub-tasks grouped by state. Progress updates live as agents complete work.

## Preview a Project

From the **Projects** page, click any Project to preview it in the left-hand panel before opening the full view.

## Import existing work to a Project

When creating a Project, you can have Korey import existing Shortcut stories and epics as a starting point, or build the Spec from scratch. The Spec is fully editable at any time to reflect new direction or scope changes.

  For a Story to appear in the Execute column, Korey needs to link or list it in the Project chat first. Ask Korey to pull in the relevant Stories, and they'll show up in the column. We're actively working on making this flow more advanced.

## Assign work to an agent

Stories and Sub-tasks in the Execute column can be assigned to an agent:

- **In the Execute column:** assign directly from the task card.
- **Through chat:** tell Korey which tasks to pick up in the Project chat.

## Share a Project

Anyone with the link to the Project can read the full Project view, including the Spec, chat, and Execute column, even if they're not the owner. Only the Project owner can interact with Korey in the Project chat.