Workspace

What a workspace is

A workspace is a folder of plain files. Every project lives inside it, in its own folder, and the app writes its settings and a guide for Claude Code next to them.

Reels/
  workspace.json               marks the folder as a workspace
  BetterEdits.md               the generated guide for Claude Code
  CLAUDE.md                    yours; it imports the guide
  .claude/settings.json        lets Claude Code run the command line without prompts
  settings/                    transcription.json, caption-styles.json, text-styles.json
  projects/<Name>/project.json one project, with thumbnail.png, exports/ and media/
  cache/                       frames/, transcripts/, reels/

The app opens on the workspace window. Without a workspace it offers New Workspace… and Open Workspace…, and lists the workspaces opened before under Recent Workspaces.

Create or open one

• New Workspace… (the workspace window, or File › New Workspace…) asks for a name and a place, creates the folder and sets it up.
• Open Workspace… opens an existing one. A folder set up by an older build that still calls itself a library is recognised and its marker renamed.
• Close (top of the sidebar, or File › Close Workspace) forgets the workspace and shows the empty state. Nothing is deleted.
• Show Workspace (⇧⌘W) brings the workspace window to the front from a project.
• Reveal Workspace in Finder opens the folder.

One workspace is open at a time. Opening another one switches to it.

Media folders

Media folders decide which files are copied.

• A file inside one of the workspace's media folders, or inside the workspace itself, is used where it is.
• A file imported from anywhere else is copied into the project's media/ folder first, once per project, and stored by relative path. The project folder then moves as one piece.

Add a media folder from the sidebar's Media Folders list, from File › Add Media Folder…, or with media-folders --add on the command line. Each project card shows its size on disk, copied media included.

To stop using a folder, click the × beside it. If videos still use files from it the app asks: Consolidate into Videos copies those files into each video's own media/ folder first, Remove Anyway leaves the references pointing at the folder, Cancel keeps it.

The Workspace panel

The Workspace button in the project toolbar opens a panel with the workspace's location, its media folders, and the media the open video uses. Each file shows its length, how many clips use it, and whether it was copied into the video. Open, Reveal in Finder and Export… are in each row's menu; Export All… copies every file somewhere else.

Single files

• Save a Copy As… (⇧⌘S) writes the open project as one .be file, JSON with media references. The project itself stays in the workspace.
• Import Project File… (⌘O) copies a .be file into the workspace as a project of its own and opens it.

Edits on disk

The app watches project.json and the settings files. A change written by another program lands live. A project rewrite arrives as one undoable step called Edit on Disk. Caption styles, text favorites and transcription rules are the JSON files under settings/.