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

# Project folder

> What's inside a CoClip project folder and where CoClip keeps its own data.

A CoClip project is a folder, not a single file. Everything the project needs lives inside it, so you can move, back up or share the whole folder. To open one, use **File** → **Open Project…** (`Ctrl+O` / `⌘O`) and pick the folder.

## Inside a project folder

```text theme={null}
My video/
  project.json     the project: timeline, tracks, settings
  history.jsonl    the edit history
  assets/          your imported media and fonts
  exports/         videos you export
  .cache/          previews CoClip can rebuild
```

| Item | What it is |
| - | - |
| `project.json` | The project itself: canvas, tracks, clips, text and settings. |
| `history.jsonl` | Every edit, by you or an agent, one line per edit. CoClip uses it for undo and the AI log. See [AI log and undo](/docs/ai-agents/ai-log-and-undo.md). |
| `assets/` | A copy of each media file and font you import. The project uses only files in this folder. |
| `exports/` | Where exports go unless you choose another place. See [Export your video](/docs/editing/export.md). |
| `.cache/` | Proxies, waveforms, thumbnails, analysis results and the project cover shown on the Start screen. You can delete it; CoClip rebuilds what it needs. |

You don't need to open these files. Edit the project in CoClip, or ask an agent.

## Move or share a project

**1. Close the project**

Choose **File** → **Close Project** so CoClip stops writing to the folder.

**2. Copy the whole folder**

Move, copy or zip the entire project folder. To save space, you can leave out `.cache/` and `exports/`.

**3. Open it in the new place**

Use **File** → **Open Project…** and pick the folder.

Things to know when you share a project:

* Fonts you used travel with the project in `assets/`. Check each font's license before you share it.
* Your connector keys are never in the project.
* Brands and reference videos live outside the project, in your CoClip library. On another computer, a project linked to a brand shows that the brand is missing. See [Brand kit](/docs/library/brand-kit.md).

If a media file goes missing, the Library marks it and offers **Relink**. See [Import and manage media](/docs/editing/import-media.md).

## Where CoClip keeps its data

| What | Windows | macOS |
| - | - | - |
| New projects (default location) | `Documents\CoClip` | `~/CoClip` |
| Brand library | `Documents\CoClip\Brands` | `~/CoClip/Brands` |
| Settings, connector settings and encrypted keys | `%APPDATA%\CoClip` | `~/Library/Application Support/CoClip` |
| Speech models, reference videos, map imagery, caches and logs | `%LOCALAPPDATA%\CoClip` | `~/Library/Application Support/CoClip` |

* On Windows, `Documents` is the folder Windows reports as yours, which may be inside OneDrive.
* On macOS, CoClip keeps its folder in your home folder, not in Documents. iCloud Drive can remove files in Documents from your Mac to save space, which slows down rendering.
* To open `%APPDATA%` or `%LOCALAPPDATA%`, type it in the File Explorer address bar. On macOS, use **Go** → **Go to Folder…** in Finder.
* The app log is `logs/main.log` inside the folder in the last row of the table. Support may ask you for it.

What happens to this data when you uninstall is covered in [Install CoClip](/docs/get-started/install.md).

## Related pages

* [Projects and project settings](/docs/editing/projects-and-settings.md)
* [How CoClip works](/docs/get-started/how-coclip-works.md)
* [Troubleshooting](/docs/reference/troubleshooting.md)


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