Skip to main content

What a project groups

A project is a workspace that keeps related work together. Every project holds:
  • Sessions — the conversations you start inside the project. Members can see and continue any session in the project.
  • Files — up to 15 pinned knowledge items shared across every session in that project. You don’t need to re-add them each time.
  • Custom instructions — text added to the system prompt of every conversation in the project. Use it to set context once (“This project covers our Q3 roadmap — respond in German.”).
  • Access control — the project can be private (only you), shared with specific users, or shared with roles.

The projects screen

Open Projects from the app sidebar. The page shows “Workspaces that group your conversations and shared context.” — your projects are listed below a search bar.
  • Search — type into Search projects… to filter by name as you type.
  • Favorites — starred projects appear in a pinned Favorites group above the full list.
  • All projects — the complete list ordered by last-updated time. Each row shows the project name, how long ago it was last updated, and a star toggle.
  • Load more — when you have more than the first page of projects, a Load more button appears at the bottom of the list.

Create a project

1

Open the create dialog

Click New project in the top-right of the Projects page (or navigate to /projects?new=1 from the command palette).
2

Name the project

Type into Name — this is the only required field. The placeholder reads “Enter project name”.
3

Add a description (optional)

Fill in Description (“Describe what this project is about…”) so collaborators know the purpose at a glance.
4

Add custom instructions (optional)

Expand Advanced and fill in Custom instructions (“Instructions every chat session in this project will follow…”). These apply automatically to every new session in the project.
New projects start as Private — only you can see this project until you share it. Change access after creation from the project’s Settings tab.
5

Create it

Click Create project. You land on the new project’s Sessions tab.

Favorites

Star any project to pin it at the top of the Projects list. The favorite state is personal — it only affects your view.
  • Add to favorites — click the star icon on any project row.
  • Remove from favorites — click the filled star to unstar it.
You can also toggle the star from inside a project using the star button in the project header.

Next steps

Work inside a project

Start sessions, pin files, and manage project settings.

Pin knowledge in chat

Add knowledge to a single session without a project.