Lettuce Docs Tags Graph

Your first vault

#docs#getting-started
~3 min read

Your first vault

A vault in Lettuce is just a folder on disk. Any folder with .md files in it can be a vault, and Lettuce doesn’t add any required structure — no hidden index, no database. If you point Lettuce at an existing folder of notes, it’ll work immediately.

Pick (or create) a folder

The simplest path: in Finder, create a folder like ~/Documents/Notes and pick that. In Lettuce:

  1. File → Open Folder… (or press ⌘O)

  2. Choose your folder

  3. The sidebar populates from the folder’s contents

Lettuce remembers the last vault you opened and reopens it on launch. To switch vaults, File → Open Folder… again. To open multiple vaults at once, File → New Window.

Make your first note

In the sidebar, click the + button (or ⌘N). A new note appears in your vault root with a placeholder name. Type a title, hit return, and start writing.

---
title: Hello, vault
tags: [hello]
---

# Hello, vault

This is my first note.

- I can use **bold**, *italics*, and `code`.
- Links work: [[02 Your first vault]] (try typing `[[` to autocomplete).
- Tasks too: 
    - [ ] Try the keyboard shortcuts
    - [x] Open my first vault

Save with ⌘S (or just leave it — Lettuce auto-saves on focus change and every few seconds).

What lives where

Path Purpose
<vault>/*.md Your notes
<vault>/Inbox/ Convention: dropbox for new captures
<vault>/attachments/ Convention: images and binary blobs
<vault>/.lettuce/ Vault-local config (order, triggers, schedules, suggestions)
<vault>/.git/ Optional. Lettuce works fine in or out of git

Lettuce is opinionated about nothing in this list except .lettuce/. The Inbox and attachments folders are just conventions baked into the AGENTS.md scaffold; you can rename or remove them.

Subfolders are first-class

Drag notes between folders in the sidebar. Create new folders with the contextual menu. Rename a folder and Lettuce automatically rewrites wikilinks across your whole vault to keep them working.

Warning

If you move or rename files outside Lettuce (Finder, git mv, an agent that doesn’t use the write tools), wikilinks won’t be auto-rewritten. The link index updates on the next vault scan, but stale link bodies stay stale until you fix them.

Open multiple vaults

File → New Window opens a fresh vault picker. Lettuce keeps separate state per window — you can have a work vault and a personal vault side by side. The MCP server runs once and serves all currently-open vaults; agents pick a vault by name (see Agent reference/03 Authentication).

Next steps