File Manager

A unified file system for organizing documents, agent outputs, and uploaded files

The File Manager provides a single place to organize all files in your workspace — uploaded documents, AI agent outputs, Collab docs, landing pages, and external links.

Spaces

Every workspace starts with three default spaces:

SpacePrivacyPurpose
My FilesPrivateYour personal files, visible only to you
Workspace FilesWorkspaceShared files accessible to all team members
Agent OutputsWorkspaceFiles generated by AI agents (reports, exports, artifacts)

File Structure

Files are organized in a tree structure with up to 4 levels of nesting:

Space (root)
  > Folder
    > Folder
      > Folder
        > File

Each node in the tree is a FileNode with a type:

  • Space — root container (auto-created)
  • Folder — organizational grouping
  • File — points to actual content via a storage backend

Storage Backends

Files in Coherence don't store content directly — they point to content via a storage backend:

BackendDescription
SpacesFiles uploaded to DigitalOcean Spaces (S3-compatible)
Collab DocLinks to a Collab document
Agent ArtifactLinks to an AI-generated artifact
Landing PageLinks to a generated landing page
External URLLinks to a file hosted elsewhere

This means moving a file between folders never moves the underlying blob — only the pointer changes.

Privacy Levels

LevelVisibility
WorkspaceAll team members can see the file
TeamOnly members of a specific team can see it
PrivateOnly the creator and explicitly shared users

Privacy cascades from parent to child. Moving a file into a private folder makes it private.

Sharing Files

Share individual files or folders with specific users:

  1. Right-click a file or folder
  2. Select Share
  3. Add team members by name or email
  4. They'll see the file in their Shared with me view

Favorites & Recent

  • Star any file or folder to add it to your Favorites
  • Recent shows files you've opened recently, sorted by last access time

Trash

Deleted files go to Trash for recovery:

  • Files in Trash are soft-deleted (marked with a TrashedAt timestamp)
  • Trash cascades — deleting a folder moves all children to Trash
  • Restore files from Trash to their original location
  • Permanently delete from Trash to remove the underlying storage

Use the search bar in File Manager to find files by name across all spaces you have access to.

Permissions

PermissionRoles
files:manageAdmin, Owner — manage spaces and all files
files:uploadAll users — upload files to spaces they can access