Projects & Compositions
How Klipeo organizes your work, and the difference between a project and a composition.
Klipeo keeps three kinds of things, and it helps to know which is which before you start: projects, the compositions inside them, and chats.
Projects hold compositions
A project is a container. Think of it as the folder for a piece of work: a client, a channel, a campaign. A composition is one actual video edit, and a project can hold as many as you want. The trailer, the full cut, and the three social clips can all be compositions inside one project.
Project
The container. It has a name, an optional description, and the collaborators you invite. It's also what connects to GitHub for versioning.
Composition
One edit. It has its own timeline, canvas size, frame rate, and duration, and it opens in the editor.
Chats
A chat is one Vibe session. Send a brief from Home and Klipeo starts a chat; the chat can belong to a project or stand alone as No project. The sidebar lists Projects with their chats nested underneath, and standalone Chats below that. Open a chat to see its transcript, and the composition it produced.
The project workspace
Open a project and you get its workspace: a composer bound to that project, then
Chats, Assets, Memory, and Drafts tabs. Each label carries its
count, and Drafts appears only when the project has drafts. Assets lists
every piece of media across the project's compositions. Memory lists the facts Vibe has saved about the
project with its project-memory skill, and you can delete any of them.
The rail beside the tabs shapes how Vibe works inside this project:
- Instructions. Free text that goes into every chat in the project.
- Skills. Which skills Vibe may use, with an optional "only added skills" restriction.
- Connectors. Which connected apps this project may act through. See Connectors.
- Files & sources. The media and documents attached to the project.
On a phone the rail becomes a Context control in the tab row, and each section opens as a full-screen sheet that saves when you close it.
Recovering a saved draft
Saved drafts let you return to an interrupted brief without starting another agent run. On Home, look above the desktop composer; on a phone, open the composer's add sheet. Inside a project, use Drafts. Choose Restore draft to continue a brief, or Review edit when the draft already has a composition. Drafts expire after 24 hours.
If the draft list fails to load, choose Try again in the error notice. The notice stays beside the project composer even when there are no drafts to show in the tab row.
Creating things
Send a brief from Home with New project picked, or hit New project in the Projects library, and Klipeo makes the project and drops you into its first composition. Inside a project you can add more compositions whenever you need another cut; new ones are named Edit 2, Edit 3, and so on until you rename them.
Each composition remembers its own canvas and frame rate, so a vertical TikTok and a wide YouTube cut can live side by side without fighting each other. A fresh one carries 1920 x 1080 (16:9), 30 fps, and a black background, but its canvas size is set to auto: it takes the dimensions of the first video you place. Pick a preset and the size is fixed to that instead. The presets are 16:9, 9:16, 1:1, 4:3, 4:5, 21:9, and 2:3, and frame rate can be 24, 25, 30, 50, or 60 fps.
Your work saves itself
You don't save by hand. The editor pushes changes to the server about 800 ms after you stop making them, and a badge in the header tells you where things stand: Saved, Saving, or Offline if the connection dropped. Try to close the tab with a save still in flight and the browser warns you first.
If a composition fails to load, the editor keeps its error screen visible. It doesn't start saving or let you edit the previous composition's contents as the one you just opened. Use Retry to load it again.
Newer version wins
If someone else (or another tab of yours) saved the same composition while you were working, your save is rejected and the editor reloads the server's version. The badge reads Reloaded, newer version, and any edits you hadn't saved yet are gone. Keep one tab per composition when you can.
Project settings
There is no separate project settings page. The controls sit where you already work:
- Rename or delete a project from the project picker in the Home composer.
- Instructions in the workspace rail is the project's AI context.
- On the Projects dashboard, a project card's menu has one item, Delete. It opens a confirmation naming the project and how many edits go with it.
- Change image is on the composition card, alongside Rename, Pin, and Delete. It is not on the project card.
A project name is capped at 256 characters by truncation, not by validation. A longer name is accepted and silently cut to 256 before it is saved.
Inside the editor, the composition info dialog shows duration, canvas size, preset, frame rate, track and item counts, media asset count, storage, the created and updated dates, and the first eight characters of the project ID. It is read only, with nothing to copy.
Why the split matters
Two reasons. First, collaborators and GitHub repos attach to the project, so everyone working on that piece of content shares one place and one history, even across several cuts. Second, your AI context attaches to the project too, so notes about the brand or the tone carry across every composition inside it.
Versioning lives at the project level
When you back a project with GitHub, each person gets one branch for the whole project, and all its compositions ride along on that branch. The details are in Projects on GitHub.
Finding your work later
Projects lists your projects, newest first, with a search box to filter them by name. Home shows the most recent ones under the composer. Open a project to see its compositions, which you can search, rename, and delete.
Pin the ones you're actually working on and they sort to the front of the list. Pins are a per-browser preference, so they follow the machine you set them on rather than your account.