# Projects

> A project is where you work: a brief in BENCHY.md, a folder of files, canvases and docs, and the chats about them.

Canonical: https://benchy.world/docs/projects
Last updated: 2026-10-27

## What's in a project [#whats-in-a-project]

Start one for a piece of work: a print, a product, a client job. Everything about it lives in a folder tree you arrange yourself. **Projects** in Studio has three views: **This workspace**, **Shared with you** (projects in other workspaces you were invited to) and **Trash**.

| Item | What it is |
| --- | --- |
| `BENCHY.md` | The project's brief, at the top of the folder tree. See [BENCHY.md](https://benchy.world/docs/benchy-md). |
| Folders and files | Any kind of file, each with a preview and its versions. See [Files and versions](https://benchy.world/docs/files-and-versions). |
| Links | Web pages kept next to the files, such as a tutorial or a supplier's page |
| Canvases and docs | Boards that lay out the project's files, and documents you write together. See [Canvases and docs](https://benchy.world/docs/canvases-and-docs). |
| Made by Benchy | Everything Benchy makes: generations, exports and print files |
| Websites | What the project publishes to the web. See [Websites](https://benchy.world/docs/websites). |
| Chats | Conversations with Benchy about this project. See [Chats](https://benchy.world/docs/chats). |

## Start a project [#start-a-project]

- **New project** in Studio: a name, a one-line description, and who can open it.
- **Open a folder** in [Benchy Desktop](https://benchy.world/docs/desktop) pairs a folder on your Mac with a project.
- Ask Benchy in a chat to start one.

## BENCHY.md [#benchy-md]

Every project has a `BENCHY.md` brief: what the project is, what has been decided, and which skills and Elements the work uses (under `## Use`). Benchy reads it before every turn, your own agents can read it too, and it travels with the files. The project page shows it in a panel beside the files. See [BENCHY.md](https://benchy.world/docs/benchy-md).

## Who can open it [#who-sees-it]

A new project is open to **Everyone in the workspace**, at their role. Choose **Only me and people I invite** to keep it to yourself and your invitees. A member who can only view sees a note saying so and can ask the owner for Can edit. Projects Benchy Desktop pairs from your Mac start private, in the workspace it is signed in to. See [Sharing](https://benchy.world/docs/sharing).

Anyone who can open a project can comment on it, or on one of its files, with **Comments** beside Share. See [Comments](https://benchy.world/docs/canvases-and-docs#comments).

## Rename, hide or delete [#rename-and-delete]

**Rename**, **Make private** and **Open to the workspace** are in the project's actions menu, next to **Share** and **Download all**.

**Move to trash** takes the project and everything in it out of the workspace. Its websites go offline. Its owner can restore it from **Trash** for 30 days; then it goes for good, with its files and websites. A file version published on World stays with its listing.