Knowledge

Your persistent file system: My Files, Memory, Skills, plus Shared folders for teammates.

Knowledge is Sauna's persistent file system. Four roots sit side by side, pickable from a left nav: My Files (your docs and folders), Memory (seven cards Sauna maintains about you), Skills (reusable playbooks Sauna can reach for), and Shared (folders you've shared with teammates, see Multiplayer). Everything a session produces, everything you upload, everything Sauna has learned about how you work lives here.

Overview

  • My Files holds folders and files you create, upload, or save from a chat. Full read/write.
  • Memory is a fixed set of seven cards. You can open and edit them, but you can't rename or delete them, and the list doesn't grow.
  • Skills is a folder per skill. Each skill is a small bundle of instructions and saved work that Sauna loads when it's relevant.
  • Select Files (top-right) flips every row into a checkbox, so you can pick a batch across My Files, Memory, or Skills and then publish or download them. Counts show on each root's nav entry so you can see what's picked at a glance.

My Files

My Files is the free-form half of Knowledge. Folders nest as deep as you like, and the breadcrumb row at the top walks you back up.

Click New + in the top-left of the panel for four options:

  • New File creates an untitled markdown file in the current folder.
  • New Folder creates an untitled folder. A second one becomes untitled (1), then untitled (2), and so on.
  • Upload File opens Finder. Sauna accepts a curated allowlist (see the card below).
  • Upload Folder uploads a whole directory tree in one go. Files outside the allowlist are skipped, and Sauna toasts a summary of what didn't make it.

You can also drag files straight onto the panel or into a specific folder. A dashed outline and "Drop files here to upload" overlay confirms the target.

Right-click a file for four actions: Rename, Download, Publish, Delete. Delete asks for confirmation. Publish toggles on and off and exposes the same public-URL flow as multi-select (details in Select, publish, download).

Publishing a single file opens a small dialog with the public URL and an Unpublish control. The same dialog previews the rendered page on the right.

Recipients open the URL and see the file rendered on app.sauna.ai/share/…. No Sauna account required; there's a "Copy to Sauna" button in the top-right for signed-in viewers.

Right-click a folder for six: New File and New Folder (create inside that folder), then Rename, Download, Publish, Delete. Deleting a folder removes everything inside it.

Memory

Memory is one of the reasons Sauna feels like it knows you. Seven cards, always there, updated in the background as Sauna learns about you from chats, files, and connected apps. You can open any card and edit it by hand, but the list itself doesn't grow or shrink.

The seven cards, in the order they appear:

  1. User Preferences
  2. Rules
  3. User Profile
  4. Your Tools
  5. Sauna Identity
  6. User Relationships
  7. Recent Activity

Each card has a short description underneath the title, set by the file itself and shown as Sauna writes it. Click any card to open it. The file opens in a viewer on the right with a Publish button in the corner. Edit the content the same way you'd edit any file in Knowledge.

Skills

A skill is a small package Sauna can pull off the shelf when a task matches. Each one is a folder under Skills with a SKILL.md that says what it does and when to use it. Sauna sees every skill on every turn and reaches for whichever fit.

Open a skill folder and you'll usually see three things:

  • cache/: data Sauna has already pulled, kept around so it doesn't have to fetch again.
  • scripts/: workflow code Sauna has saved so the work runs faster next time.
  • SKILL.md: the one-page description. What the skill does, when to use it, keys and config it needs.

You don't "run" a skill directly. You chat, and if a skill applies, Sauna reaches for it. The skill text becomes context; the scripts and cache speed the work up.

Select, publish, download

The Select Files button in the top-right flips every row into a checkbox. Pick a mix of files and folders, then either publish them as a single shareable link or download them to your machine.

The selection count shows next to each root in the left nav, so you can hop between My Files, Memory, and Skills and still see what's on deck. A three-dots menu in the top-right reveals two actions: Publish selected and Download selected.

Publish selected

Clicking Publish creates a public URL anyone can open on app.sauna.ai/share/…. Sauna warns you up front that the link is a single-use static snapshot before you publish; a second reminder follows after, right before the dialog closes. The post-publish dialog reports the file count ("36 files published"), offers a Copy link button, and says explicitly: "This link will not be accessible again after closing this dialog." Copy the URL before you hit Done; future edits to the files won't show up on that URL. If you need to re-share after edits, publish again.

The published URL renders the selected files as a read-only page for the recipient. They don't need a Sauna account.

Download selected

Download behavior depends on what's selected:

  • A single file downloads as the file itself, no wrapper.
  • Two or more items (or a single folder) come back as a zip. A multi-root pick is named SaunaDump-YYYY-MM-DD-HHMMSS.zip with workspace-relative paths preserved inside. A single folder download uses the folder's own name, e.g. documents.zip, with paths relative to that folder.

Click Done in the top-right to leave select mode.