Projects and tasks
Organize creative work so every agent has the right files, scope, and context.
On this page
Projects group related work#
A project is the top-level container shown in the sidebar. Use one project for a film, campaign, client, show, or other body of related work.
- New Project creates a VideoDraft-managed project.
- Open Folder lets VideoDraft work directly in a folder you already own.
- Clone GitHub repo is available when the work is stored in GitHub.
Give each outcome its own task#
Each task has its own folder on disk. Keep the revisions of one piece of work in a single task. Start a new task when the outcome or its owner changes, so prompts, files, and chats stay clear.
| Use one task for | Start another task for |
|---|---|
| A teaser and its revisions | A separate customer campaign |
| One storyboard and its generated shots | An unrelated music-video concept |
| A recurring social content task | A one-off product launch |
Opened folders are edited in place
When you open a folder, agents read and write that folder directly. There is no hidden copy.
Task files#
- Put scripts, briefs, shot lists, notes, and final documents in the task folder.
- Put generated or fetched images, video, and audio under media/.
- Do not add media/ or other content folders to .gitignore. Ignored files drop out of chat mentions and change tracking.
- Use .context/ for scratch notes and handoffs between agents. Keep finished work outside it.
- Link another task or folder when an agent needs additional source material.
launch-teaser/
├── brief.md
├── treatment.md
├── shot-list.csv
├── media/
│ ├── keyframe-01.png
│ ├── teaser-v1.mp4
│ └── voiceover.wav
└── .context/
└── handoff.mdWork alongside the agent#
The right panel is your own view of the task the agent is working in. Drag either panel to resize it, or drag one to a sliver to collapse it. The panel has tabs across the top and a drawer along the bottom.
| Top tab | What it gives you |
|---|---|
| Files | The task folder as a tree. Click to preview a file, including images, video, and 3D models such as .glb, .usdz, .fbx, and .obj. Double-click to pin it as a tab. |
| Activity | What the agent is doing right now. |
| Changes | What has changed against the task target, the branch the task started from, with a count of changed files. Code mode. |
| Git | Branch controls, review, and pull request actions. Code mode. |
| Editor | The VideoDraft Editor project linked to this chat. VideoDraft mode. |
| Bottom drawer | What it gives you |
|---|---|
| Setup | The project setup script and its output. |
| Run | Your project run command, configured in Settings > Projects, for a long-lived dev server. |
| Terminal | Real shell tabs, opened in the task folder with the project environment variables set. Add more and they number themselves. |
Link extra folders#
An agent can read and write outside its task once you link a folder. Open the plus menu in the composer, the message box at the bottom of a chat, then choose Link workspaces. That menu item links another task or any folder, and /add-dir with a path does the same.
- Search for a task in any project, or browse for any folder on your Mac.
- Linked folders appear as chips above the composer. Unlink them from there.
- Links belong to the task, so every chat in it shares them and they survive restarts.