Organize and protect your notes
Frontmatter and two small files at the vault root control what your agent sees, how important each note is, and what never leaves your disk.
Frontmatter
Add YAML frontmatter to any note:
aether_tieracceptshot,warm,cold, orprivate(defaultwarm). Notes markedhotload into[AETHER_HOT_PROFILE]on every recall. Notes markedprivatenever leave your vault.aether_scopetakes one scope, a comma-separated list,[a, b], or a YAML list (defaultglobal).aether_kindis one ofprofile,rule,decision,spec, orfleeting.
Keep a note private
---
aether_tier: private
---
# Personal keys
Local credentials that stay on disk only.
AMC filters private notes on your device before it builds any request, and the server refuses to read or delete them.
To check it, run Sync vault with Aether and confirm the notice reports private notes kept on your device.
You can also call POST /v1/inspect or aether_inspect_source with the note path and confirm the server rejects it.
Exclude folders with .aetherignore
Create .aetherignore at the vault root to skip whole folders or filename patterns:
Finance/
*.secret.md
Built-in rules already skip .obsidian, .git, .trash, .aether, Aether/Inbox.md, Aether/Compiled, .canvas, .excalidraw, and .excalidraw.md.
Pin notes into the hot profile with .aetherhot
To load notes into [AETHER_HOT_PROFILE] without editing their frontmatter, create .aetherhot with the same syntax:
Memory/
Profile/*.md
Matched notes become hot unless their frontmatter sets an explicit aether_tier.
Reference
Every key, default, and rule is in Vault files and frontmatter.