App tour
App tour
Lettuce’s UI is split into three panes plus an inspector. This page is a 5-minute orientation.
The sidebar
Left pane. Shows your vault’s folder tree with these niceties:
Folders are real folders — drag and drop, rename, delete, all map to the filesystem.
Custom order — drag a note to reposition it; the order is persisted in
.lettuce/order.json(see Core concepts/02 The .lettuce directory).Sort toggle — header → context menu → Sort by: Manual / Name / Modified / Created.
Quick filters — type in the search box to filter by name; prefix with
#to filter by tag.
Right-clicking a note offers: Rename, Duplicate, Move to…, Reveal in Finder, Copy wikilink, Delete.
The editor
Centre pane. CodeMirror 6 with a Live Preview mode (the default):
Headings render as headings; you still see them as you type.
**bold**shows as bold unless the cursor is on that line.Wikilinks (
[[name]]) collapse to just the name; click to follow.Tasks (
- [ ]) show real checkboxes you can click.
Toggle between Edit (Live Preview) and Read (full render, read-only) with the segmented picker in the center of the toolbar.
Autocomplete
Type
[[→ wikilink suggester. Hit tab to accept.Type
#at the start of a word → tag suggester (uses your existing tags).Type
> [!→ callout chooser.Type
:and a name → emoji picker (matches:tada:,:rocket:, …).
The inspector
Right pane (toggle with the inspector button in the toolbar). Tabs:
Backlinks — every note that links here.
Outline — every heading in the note, click to jump.
Graph — the local link subgraph around this note.
Agent edits — the revert-able timeline of writes agents made to this note.
Ask This Note — chat with the AI about the current note (vault-wide questions live in the toolbar’s Ask Your Vault…).
Pending proposals — queued propose-only edits awaiting your review.
Publish Site — the guided GitHub Pages checklist: account, repository, what will publish, deploy.
Maintained notes
Several overviews that other apps bury in panels are, in Lettuce, just notes the app generates for you — open, edit, link, and publish them like anything else. Open them from the Open ▾ menu in the toolbar (the iPhone has the same menu on the Notes tab). They live in an Overviews/ folder so they don’t clutter your vault root (the daily note stays in Daily/):
Today (
⌥⌘D) — your daily note (Daily/<date>.md): the morning briefing (AI digest), the day’s calendar agenda, and what’s due. The Open button shows a dot when a new briefing has landed.Tasks (
⌥⌘T) — every open to-do across the vault in one livetasksrollup.Published Pages — every published note and tagged artifact, with its live URL. (Distinct from the inspector’s Publish Site panel, which is where deploying is set up.)
Vault Review (also File ▸ Review Vault) — the structural linter’s findings as a checklist you tick off; each links to the note it flags.
Ask Log — on iPhone, an answer from Ask your notes can be saved (with its sources as wikilinks) into a running log so research stays in the vault.
The command palette
⌘⇧K — the AI actions palette: a searchable list of AI actions to run against the current note (the result is spliced back in as an > [!ai-done] callout). To jump to a note by name instead, use Quick Open (⌘O).
The agents sidebar
The right-edge inspector / agents panel shows:
Server status (running / stopped)
Connected agents with last-call timestamps
Pending proposals across the whole vault
Recent agent activity log
This is also where you see “John (Claude Desktop) wrote 3 notes” notifications.
The graph view
View → Graph (or ⌘G). A force-directed graph of your wikilinks. Click any node to open. Useful for finding orphans (nodes with no edges) and exploring clusters.
Settings
⌘,. Three tabs:
General — appearance; the Agent API server (start/status); API keys (create scoped agent keys, toggle propose-only); and AI enhancement (the LLM/embeddings provider).
Reactivity — edit the vault’s
triggers.ymlandschedules.yml.About — version, documentation links, and support info.