Working with files in MyVault
Learn about Working with files in MyVault in WaymakerOS.
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
.vaultpinwith 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-refreference, 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
.vaultpinis 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.