Add, find, preview, download and remove the documents in your Sasha, and know what Sasha does to each file you upload

The Files panel shows every folder and document in your Sasha. See how uploads become Markdown, how previews and downloads work, and why member-home files open isolated.

Where

The Menu button in the top bar, then Files (on a phone, the Files tab). A document in a project's Knowledge list also opens here.

Who

Admin and staff accounts. Members cannot open the web interface; they read and write their documents from Claude.

Needs

An admin or staff account. Some previews (PowerPoint, HEIC and TIFF images) need conversion tools that the standard Sasha server has.

What this screen is for

The Files panel shows all the knowledge in your Sasha as folders and files. Each project has a folder here, with the project's folder name (not its label in the side menu). Member homes are folders too, named member- and a number. Admin and staff accounts see every folder.

To open it, click Menu in the top bar, then Files. A link to a document or folder in Sasha also opens the panel, filtered to that place; the header then reads "Knowledge:" and the path.

The toolbar

The buttons have no text. Hover over a button to see its name.

On a narrow panel, some buttons hide. Use Fullscreen to see them all.

Labels on files and folders

Each file shows a coloured label for its kind, for example Policy, Guide, Uploaded, Converted or Research. A file with no other kind shows Research. Folders that Sasha uses for itself show System: agents, prompts, skills, system, tools, uploads and some others. Leave these folders to Sasha.

Actions on a row

Upload a document

1. Open the folder of the project, or drop the files on the folder's row.
2. Click Upload files, or drag files into the panel.
3. Wait for "N file(s) converted to Markdown and added to project documents".

For each file, Sasha:

• keeps the original in the uploads folder, under originals and the project's name;
• writes a Markdown copy (.md) in the folder you chose, with a short header that names the original, the date and who uploaded it;
• adds _1, _2 and so on to the name if a file with that name exists.

The file picker offers PDF, Word, Excel, PowerPoint, text, Markdown, CSV, JSON and zip files. Sasha and Claude find an uploaded document through its Markdown copy (see Understand how Sasha and Claude find your documents, and why two searches can give different results).

Zip files

Drop one zip file at a time. If files in the zip exist already, the Extract Zip dialog asks: Skip Existing, Keep Both or Overwrite. Answer within 15 minutes, or start again. Sasha refuses the whole zip if it holds more than 5,000 files, and it skips links. The extracted files keep their own format; Sasha makes no Markdown copies.

Preview and edit a document

Click a file to open the preview beside the list.

The buttons above a document preview are Edit, Copy content, Copy path, Edit tags, Download MD, Download PDF, Download DOCX and Delete. Some hide when the panel is narrow.

Edit opens a Markdown document as text that you can change. Click Save (or press Ctrl+S) to keep your changes, or Cancel (or press Esc) to drop them. Edit is not available on a read-only file.

Delete files and folders

• Delete asks "Are you sure you want to delete" the file, and warns that the action cannot be undone.
• When you delete a Markdown document, Sasha also deletes a web page of the same name next to it, if there is one.
• The original of an uploaded file stays in uploads. Delete it there if you need to.
• Sasha refuses to delete its own files, its top-level System folders and the root folder of a member's home. The delete button is hidden on System files and folders. It still shows on the root folder of a member's home, and the delete then fails with "A member home folder cannot be deleted or moved."

Why member-home files open isolated

A member writes the files in their home from Claude. Admin and staff accounts open the same files in the web interface. A file can contain a script, and a script in a page runs as the person who opens it. So Sasha opens every file from a member's home in an isolated frame:

• a web page from a home can run its own scripts, but it cannot read your session or act in the web interface;
• a converted Word or Excel preview from a home runs no scripts at all;
• raw HTML inside a Markdown document from a home is not shown as HTML.

Files in ordinary shared projects open normally, because their reports can need scripts. For where your files live, see Where your data lives in Sasha.

Limits to know

• Today, a JSON upload gets no Markdown copy and does not appear in the folder you chose. Sasha keeps only the original, in the uploads folder. The upload message still counts it as converted.
• Allowed File Types in Settings → General only lists types. It does not limit what the server accepts.
• The Files panel shows folder names, not project labels. A renamed project keeps its first folder name here.
• Deleting a project with Also delete all files in this project leaves the project's folder here. Delete it yourself (see Organise the projects in the side menu, and understand what rename, archive, delete and member homes really do).
• The original of a file uploaded into a member's home goes to the shared uploads folder, outside the home.
• A PDF from a member's home opens in the browser's PDF viewer, without the isolated frame.