Browse and organize files
Click a file to open it in a tab. Shift-click to select a range, or Cmd-click (Mac) or Ctrl-click (Windows/Linux) to add items to the selection. Drag items onto a folder to move them there. Right-click a file or folder to rename, duplicate, copy its path, or delete it. In a local workspace in the desktop app, you can also reveal it in Finder or File Explorer. To create files and folders or change the sort order, open File actions (…) in the Files header. To see dotfiles such as.gitignore, turn on Show hidden files there.
In a shared workspace, creating, moving, and uploading files requires the Editor or Owner role.
Clone a repository
To start a workspace from a GitHub repository, open an empty workspace and choose Clone from GitHub. The option is in File actions and in the empty file explorer. Typeowner/repo or paste a GitHub URL.
Latest commit only is on by default. It clones much faster but skips history, so tools that read git log won’t work. Turn it off when you need the history.
- If the workspace already has files, create a new workspace to clone into. If Clone from GitHub is missing from an empty-looking workspace, turn on Show hidden files to check for hidden contents.
- If you cancel partway, Qualia removes what had arrived, so the workspace is empty again.
- If you close the dialog, the clone keeps running. A notification shows its progress and offers Cancel.
Upload files
To add files from your computer, drag them onto the file tree, or choose File actions → Upload files. In Qualia Cloud, File → Upload Files works too. Dropping onto a folder uploads into that folder. The menu actions upload into the top level of the workspace. To stop an upload, click Cancel upload in the Files header or the progress notification. Files that already finished stay in the workspace. Only one upload runs at a time, so wait for it to finish before you start another. If you switch workspaces during an upload, the upload stops. Files that finished stay in the original workspace, and the notification lists them.Uploading never overwrites a file. If the name is taken, Qualia keeps both and renames the new one, so
data.csv becomes data (1).csv.Upload a folder
To upload a whole folder, drag it onto the file tree. You can also choose Upload folder from File actions or a folder’s right-click menu. Qualia recreates the folder structure at the destination. Qualia skips dependency and scratch folders, such as.git, node_modules, and .venv, and any file your browser can’t read. A message says how many items it skipped. One upload can hold up to 10,000 files. If a folder holds more, split the upload or clone the repository instead.
If some files fail to upload, Qualia lists them so you can retry.
Upload size limits
If a file is too large for your workspace, Qualia shows the limit that applies. Local uploads are limited only by free disk space. A large file can take a while to finish after its transfer looks complete. Keep the app or browser tab open until Qualia confirms the upload. If a file shows Not visible yet, click Retry sync.Download files and folders
In a cloud or remote workspace, right-click a file or folder and choose Download. Folders download as ZIP archives, and Qualia reports anything it left out. In a local workspace, use Reveal in Finder or Reveal in File Explorer instead. Files too large for the editor show a Download button, so you can open them in another app.Edit text files together in Cloud
In Qualia Cloud, Owners and Editors can edit the same text file at the same time. Everyone works in one shared draft of unsaved edits, and Viewers and Commenters watch it change live. Undo only reverses your own edits. Your edits reach collaborators on their own, but saving to the file is manual. Choose File → Save or press Cmd/Ctrl+S. The status beside the editor shows whether the draft is saved to the file. Don’t close or refresh the tab while it shows Syncing…, because unsynced edits can be lost.Changes from agents and the terminal
Agents and shell commands read and write the saved file, not the shared draft. If the file changes on disk after the draft started, a notice above the editor lets you view the disk version, keep your draft, discard it, or overwrite the file. To keep both versions, choose File → Save As… and save the draft to a new path.Other file types
- CSV and TSV files support shared editing in Source view, unless they’re large. See the CSV editor.
- Notebooks have their own shared editing, where everyone with edit access, agents included, edits at the same time. See Edit a shared notebook together.
- Rich-text writeups don’t support simultaneous editing.
- Visitors on an Anyone with the link share see the saved file, not the unsaved draft.

