All chapters
Getting started
Daily work
Find and understand
Research and publish
Protect your notes
Reference
Header across macOS
You don't have to open Header's window to use it. Notes can show up in Spotlight, Shortcuts and Siri can read and add to them, a widget and a menu-bar icon keep capture close, and scripts or other AI apps can query your vault. This chapter lists each one with its real names and limits.
Spotlight On-device
With Spotlight indexing on, press ⌘Space, type a few words from a note, such as visa appointment, and pick the Header result. Header opens at that note.
On macOS 27 this is on unless you turn it off. On earlier versions it starts off, and you turn it on with Include notes in macOS Spotlight search. Header gives Spotlight each note's title, a short preview and up to about 24,000 characters of its text, kept in this Mac's private index, which Siri also uses. Locked notes are listed by title only. Header updates the index as you save, rename and delete notes, and turning the setting off clears Header's entries straight away.
Shortcuts & Siri actions Automation
Open the Shortcuts app and search for Header to see these actions. Notes, folders, tasks, vaults and lenses appear as pickers, so you choose them from a list rather than typing a path.
| Action | What it does | Opens Header? |
|---|---|---|
| Add to Header | Opens Quick Capture. | Yes |
| Ask Header | Opens the Ask Header panel. | Yes |
| Open Daily Note | Opens today's daily note, creating it from your template if needed. | Yes |
| Open Note | Opens the note you pick. | Yes |
| Search Notes | Returns notes that contain your words, 10 by default. | No |
| Get Note Content | Returns a note as Markdown or plain text. | No |
| Create Note | Creates a note with a title and optional content, at the top of the vault unless you pick a folder. | No |
| Append to Note | Adds text to the end of a note. | No |
| Add Task | Adds a task, with an optional due date, to a note or to today's daily note. | No |
| Complete Task / Reopen Task | Marks a task done, or open again. | No |
| Set Task Due Date | Sets, changes or clears a task's 📅 due date. | No |
| Ask Header a Question | Answers from your notes on this Mac, using Apple Intelligence when it's available and otherwise the exact matching passages, and names the notes it used. | No |
| Run Lens | Returns the rows of a saved lens, 50 by default. | No |
The actions that don't open Header can be chained. For example, Search Notes for “invoice”, then Get Note Content on the first result, then a text step of your own. Changes made by these actions are saved to Time Travel first, and on macOS 26 and later you can undo an Append to Note. While Header is locked, or for a locked note, they stop and tell you why. See Siri, Shortcuts and locked notes.
Asking Siri
Some actions come with ready-made phrases, such as “Add to Header”, “Open my daily note in Header”, “Add a task in Header” and “Ask Header a question”. On macOS 27, Siri can also work with Header notes and tasks more directly: create a note, add text to one, change a note's title (the file name stays the same), and add or update tasks. If you ask Siri to delete a task, Header marks it cancelled instead of removing the line.
The Header widget
The widget shows your vault name, a one-line focus summary, and counts for notes captured today, this month, and your open loops.
- Small: the summary and counts. Clicking the loops count opens Today; clicking anywhere else opens Quick Capture.
- Medium: adds up to three recurring themes, your two most recent captures, two open tasks, and Capture and Today buttons.
- Large: the same, with up to five open tasks.
On macOS 15 and later, clicking a task in the widget brings Header forward and marks the task done in its note. Header checks that the task text still matches before ticking it, so an out-of-date widget can't tick the wrong line. On macOS 14, clicking a task opens its note instead.
Control Center control
On macOS 26 and later, Header adds a control called Header Quick Capture. Add it to Control Center and one click opens Quick Capture.
The header:// links
Open any of these links from a launcher, a script (open "header://daily") or a link in another app. Remember to URL-encode spaces in parameters, for example Lisbon%20trip.
header://dailyopens today's daily note, creating it from your template if needed.header://todayopens Today.header://captureopens Quick Capture.header://askopens Ask Header.header://search?opens search, filled in withq= words qif you give it.header://open?opens a note by title, alias or file name, the same way anote= Lisbon%20trip [[link]]resolves.file=andtitle=work in place ofnote=.header://new?creates a note at the top of the open vault and opens it. Withouttitle= …& content= … content, the note starts with the title as a heading.header://canvascreates a new canvas;header://canvas?opens one by its path inside the vault.file= Boards/ Plan.canvas header://manuscriptopens Manuscripts; add?note=with a manuscript's path or title to open that one.header://task/marks one open task done.complete? note= …& line= …& text= … noteis the note's path inside the vault,linecounts from 1, andtextmust match the task. This is what the widget uses.
Every link brings Header's window forward. While Header is locked, it asks you to unlock and ignores the link; open it again afterwards.
Coming later: the command-line tool and AI-app access Not in the beta
Header has a small command-line tool, header, that can capture, search and open notes from Terminal, and an MCP server that lets AI apps read a vault you choose: read-only, with locked notes left out and every request logged on this Mac. Neither is included in the beta. The tool will be bundled with Header if testers ask for it, and the Settings section for AI-app access appears once it's installed. If you'd use either, tell us.