Using Saga/Your Vault

Your Vault

A dedicated folder on your computer that serves as Saga's memory.

What Is a Vault?

Your vault is Saga's memory. Everything in this folder—notes, journal entries, documents—is what Saga uses to understand you and your life. The more you add, the better Saga knows you.

Saga has permission to use its tools within your vault: reading files, creating notes, searching content, and more.

Your conversations are also specific to your vault. When you switch vaults, you get a fresh conversation with context from that vault's files.

Everything stays on your device. Saga works with standard files and folders that you own and control.

Managing Your Vault

The best way to manage your vault is through Saga itself. When you ask Saga to create notes, organize files, or update documents, it uses the same tools you see in conversations.

You can also use external apps like Obsidian, VS Code, or any text editor to view and edit your files directly.

Folder Structure

A typical vault looks like this:

~/Saga/
├── .saga/           # Internal Saga data (do not modify)
│   ├── journal/     # Daily journal entries
│   └── chat/        # Conversation history
├── journal/         # Journal protocol (default)
└── [your folders]/  # Organize however you like

Outside of .saga/, you're free to organize files however works best for you.

The .saga Folder

The .saga/ folder contains Saga's internal data—journal entries, conversation history, and settings.

Do not modify this folder. Saga manages it automatically. Editing files here may cause unexpected behavior.

Protocols

Protocols are conventions for organizing folders that Saga understands. They help Saga know where to put certain types of content.

Journal Protocol

Every vault comes with the journal protocol at /journal.

This is where Saga creates dated entries (like 2026-01-14.md) when you ask it to journal or capture thoughts.

Best Practices

•One vault per account. We recommend using ~/Saga as your home directory for Saga.
•Let Saga manage files. Use Saga's tools to create and organize files—it keeps everything consistent.
•Backups coming soon. We're working on built-in backup and sync. For now, your files are standard markdown—back them up however you like.
•Don't touch .saga/ This folder is for Saga's internals. Let Saga handle it.

Changing Your Vault

You can change your vault location in Settings → Vault. Your conversation history stays intact when you switch.