MyVault

Working with files in MyVault

Learn about Working with files in MyVault in WaymakerOS.

FilesUploadAny Size
Last updated: October 21, 2026•6 minutes read

Your MyVault holds files of any size right alongside your notes — a 2 KB note and a 500 MB video are equally at home. Large files are kept in secure cloud storage and referenced from your vault, so your vault stays fast while your files stay safe and yours.

There's no size limit beyond your plan's storage quota.

Add a file

Pick whichever fits how you work:

From your AI assistant

Just ask. For example: "Save this PDF to my vault under reports/2026." Your assistant handles the upload and files it for you — for large files it uses the any-size upload, for smaller ones a quick attach.

From the terminal

This can also be done from the Waymaker CLI — see the command reference in the developer docs.

By default a file lands under attachments/. Use --path to choose where it goes. See the full vault command reference.

From Commander (web)

Attach a file to a note from the MyVault area in Commander — it's stored securely and shown alongside your note.

How big files are handled

When you add a large file, it uploads directly to secure storage — the bytes don't pass through Waymaker's servers, which is why there's no size cap. A small reference is kept in your vault so the file is indexed with your notes, previews where supported, and counts toward your storage.

Identical files are de-duplicated automatically, so re-adding the same file is instant and doesn't use extra storage.

The nightly tidy

If a large file goes straight into your vault — from your editor, the terminal, or a sync — Waymaker tidies it overnight: binary files over 100 KB, and any file over 1 MB, are moved to Workspace storage and replaced in your vault with a small reference (a .workspace-ref file next to where the original was). This keeps your vault quick to open and sync. Notes and other text files under 1 MB are never moved.

If the same file comes back into your vault later with the same contents, the tidy reuses the copy already in Workspace storage instead of storing it again, so it doesn't use your storage twice.

Keep a file in your vault (.vaultpin)

Sometimes you want a large file to stay in your vault as a real file — a client deliverable you work on offline, say. List it in a file called .vaultpin at the top of your vault and the nightly tidy will leave it alone, at any size.

.vaultpin uses the same pattern style as a .gitignore file, one pattern per line:

# Client deliverables stay in my vault
Clients/**/*.pdf

# Everything in this folder, wherever it is
Board packs/

# One specific file
Projects/Acme/brand-guidelines.pptx

# ...except the videos
!Clients/**/*.mp4
  • * matches any characters in a name, ** matches any number of folders.
  • A pattern without a / (other than at the end) matches at any depth; start it with / to match only at the top of your vault.
  • A folder name keeps everything inside it.
  • ! un-pins something an earlier line pinned — the last matching line wins.
  • Lines starting with # are comments. Patterns are case-sensitive.

Things to know:

  • Commit .vaultpin with your vault. The tidy reads the version saved in your vault, not one sitting only on your computer.
  • Pinning doesn't bring a file back. It stops the tidy moving a file again. To get the real file back in place of a .workspace-ref reference, restore it into your vault, then pin it so it stays.
  • Pinned files make your vault bigger. Pin what you need offline, not whole folders of video — a very large vault is slower to open, sync and clone.
  • A line we can't read is skipped, and the rest of the file still applies. If .vaultpin is larger than 16 KB or has more than 500 patterns, nothing in your vault is moved until it's trimmed back — we would rather leave everything in place than move something you meant to keep.

Download a file

Ask your AI assistant for a file ("get me the brand deck from my vault") and it returns a secure, short-lived download link. In Commander, open the file from the note that references it.

Delete a file

Ask your assistant to "remove the brand deck from my vault," or it can use the delete action directly. The reference is removed from your vault and the stored bytes are reclaimed automatically. (Deleting a file doesn't touch the notes that mentioned it — update those separately if needed.)

Storage & quota

Files count toward your plan's storage allocation. Check your usage any time — your AI assistant can report it (commander_notes_vault_status), or view it in Commander. If you're near your limit, remove files you no longer need or upgrade your plan.