Instructions
Give Saga persistent memory and context that carries across every conversation.
What Are Instruction Files?
Instruction files are markdown files in your vault that Saga reads at the start of every conversation. They let you give Saga context about yourself, your preferences, and how you want it to behave.
Think of it as Saga's long-term memory—information that persists across sessions without you having to repeat yourself.
Supported File Names
Saga looks for instruction files in this priority order:
- 1.
SAGA.md— Saga-specific instructions - 2.
CLAUDE.md— Compatible with Claude Code - 3.
AGENTS.md— Compatible with other AI tools
Saga uses the first file it finds. You can customize this order in Settings → Vault.
How It Works
When you start a conversation, Saga automatically reads your instruction file and keeps that context in mind. You don't need to remind it—the instructions are always there.
You can also ask Saga to update your instruction file during a conversation:
“Add to my instructions that I prefer morning meetings before 10am”
Saga will edit the file directly, so the change persists for future conversations.
Common Use Cases
Personal Information
Tell Saga about yourself so it can personalize responses.
I work remotely and my partner's name is Alex.
Vault Structure
Help Saga understand how your files are organized.
- /journal - daily entries (YYYY-MM-DD.md)
- /projects - active project notes
- /people - notes about people I know
Routines & Habits
Share your routines so Saga can support them.
I track habits in a SQLite database—ask me about streaks.
Tone & Personality
Tell Saga how you want it to communicate.
Don't sugarcoat feedback—I prefer honesty over comfort.
Goals & Priorities
Keep Saga aligned with what matters to you.
1. Launch my side project by March
2. Exercise 4x per week
3. Spend more quality time with family
Tips
- •Start simple. You can always add more as you discover what's useful.
- •Update it as your life changes. Ask Saga to make edits for you.
- •Use markdown formatting—headers, lists, and sections help organize longer files.
- •If you use Claude Code or other AI tools,
CLAUDE.mdworks across both.