Getting Started

Your First Vault

Six steps from an empty folder to a connected, AI-native knowledge base.

1. Create or open a vault

A vault is just a folder of Markdown files. Point Metis at a new folder, or open an existing one - including an Obsidian vault. Files on disk are the source of truth; Metis is a fast native view over them.

2. Write your first note

Create a note and start typing. The live-preview editor styles Markdown as you type and hides syntax markers on inactive lines. Switch to Reading mode to render the full document with tables, code, and LaTeX math.

3. Connect notes with links

Type [[ to link to another note, or [[Note# to link straight to one of its headings - Metis autocompletes them. Backlinks appear automatically on the other side, hovering a link previews the target note or section, and the graph view shows your growing web. Unlinked mentions surface notes that reference the current one in plain text.

4. Add structure with properties

Give a note typed properties (status, owner, due, custom keys) as YAML front matter, edited as color-coded chips. Checklist tasks and due dates roll up into the agenda, grouped by date.

5. Turn on git history (optional)

Make the vault a git repo to get snapshots, per-note history, side-by-side diffs, and one-click restore - plus optional auto-snapshot. Real provenance for your knowledge, using standard git.

6. Use on-device AI (optional)

On an Apple Intelligence device (macOS 26 or iOS 26), summarize notes, get writing assist on a selection, accept tag/link suggestions, and Ask Vault for answers across your notes with citations - all on-device, nothing uploaded.