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

# How CoClip works

> Projects are folders on your computer, and you and your AI agents edit them together, live.

CoClip has three parts: a project folder on your computer, the editor you work in, and the AI agents you invite. All three see the same timeline at the same time.

```mermaid theme={null}
flowchart LR
  you["You, in the editor"] -->|edits| project[("Project folder")]
  agent["AI agent"] -->|"edits through CoClip tools"| project
  project -->|"live updates"| you
  project -->|"reads"| agent
```

## A project is a folder

Every project is a normal folder. You choose where it lives when you create it; by default CoClip uses `Documents\CoClip` on Windows and `~/CoClip` on macOS.

| Inside the folder | What it holds |
| - | - |
| `project.json` | The timeline: tracks, clips, text, captions and settings |
| `assets/` | The media and fonts the project uses |
| `exports/` | Your exported videos |
| `history.jsonl` | A log of every edit, yours and the agents' |
| `.cache/` | Previews and analysis CoClip can rebuild |

CoClip saves each edit to the folder right away. The title row shows **Saved** and a **Revision** number that grows with every edit. See [Project folder](/docs/reference/project-folder.md) for details.

## You and your agents edit together

An agent edits a project through CoClip's own tools, the same way you do. You can run one in the **AI** dock inside the editor, or connect one from outside, such as Claude Code in a terminal.

* **Edits appear live.** While the project is open, you see each agent edit on the timeline as it happens.
* **Every edit has an author.** The **AI log** lists agent edits by session name, such as **Claude 1** or **Codex 1**.
* **Undo stays per session.** Ask an agent to "undo my last edit" and it undoes only its own session's edits. See [AI log and undo](/docs/ai-agents/ai-log-and-undo.md).
* **Several agents can work at once.** Each session is a tab in the AI dock.

## Nothing happens behind your back

* An export starts only when you or your agent asks for one.
* When an agent needs a preview or an export while the editor is closed, CoClip opens the normal editor window for that project. Nothing renders in the background.
* Each project opens in its own window. An agent that opens another project opens it in a new window behind yours, with a notice.

## Your computer, your accounts

* Projects, media and exports stay on your computer. Transcription runs on your computer too, unless you pick an online engine.
* Online services are optional. You add them as [connectors](/docs/reference/connectors.md) with your own API keys. CoClip stores the keys encrypted and never writes them into projects.
* AI agents use your own sign-in and your own plan with their provider.

## Related pages

* [Quickstart: your first video](/docs/get-started/quickstart.md)
* [AI agents overview](/docs/ai-agents/overview.md)
* [The AI dock](/docs/ai-agents/ai-dock.md)
* [Connect agents outside the editor](/docs/ai-agents/outside-the-editor.md)
* [Menus and windows](/docs/interface/menus-and-windows.md)


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