All chapters
  1. Getting started

    1. Start here
    2. Install, update & first launch
    3. Bring your notes in
    4. Your vault & the window
  2. Daily work

    1. Writing & the editor
    2. The Note Inspector & history
    3. Capturing ideas
    4. Today & daily notes
    5. Tasks
    6. Minutes: recording meetings
  3. Find and understand

    1. Finding & connecting notes
    2. Setting up AI
    3. Ask Header
    4. AI writing tools: Review, Refactor & the selection assistant
    5. Lenses
    6. Atlas
    7. Mindprint, Review & Retro
  4. Research and publish

    1. Research & the Reading Room
    2. Manuscripts
    3. Boards
  5. Protect your notes

    1. Trust, safety & privacy
    2. Sync & backup
  6. Reference

    1. Header across macOS
    2. Settings
    3. Keyboard shortcuts
    4. Help, feedback & FAQ
Beyond the window

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

Find a note from anywhere on your Mac

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.

Find it Settings → General → Capture → Include notes in macOS Spotlight search

Shortcuts & Siri actions Automation

Every action Header offers

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.

ActionWhat it doesOpens Header?
Add to HeaderOpens Quick Capture.Yes
Ask HeaderOpens the Ask Header panel.Yes
Open Daily NoteOpens today's daily note, creating it from your template if needed.Yes
Open NoteOpens the note you pick.Yes
Search NotesReturns notes that contain your words, 10 by default.No
Get Note ContentReturns a note as Markdown or plain text.No
Create NoteCreates a note with a title and optional content, at the top of the vault unless you pick a folder.No
Append to NoteAdds text to the end of a note.No
Add TaskAdds a task, with an optional due date, to a note or to today's daily note.No
Complete Task / Reopen TaskMarks a task done, or open again.No
Set Task Due DateSets, changes or clears a task's 📅 due date.No
Ask Header a QuestionAnswers 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 LensReturns 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.

Try this In Shortcuts, make a new shortcut with Add Task, type Renew passport, set a due date, and run it. The task lands in today's daily note without Header coming to the front.

The Header widget

Small, medium and large

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.

Find it Right-click the desktop → Edit Widgets → search “Header”

Control Center control

macOS 26 and later

On macOS 26 and later, Header adds a control called Header Quick Capture. Add it to Control Center and one click opens Quick Capture.

Find it Control Center → Edit Controls → search “Header”

Menu-bar capture

Quick Capture without the main window

While Header is running, a pencil-and-square icon sits in the menu bar. Click it for a small panel with the same composer as Quick Capture, including the destination, voice capture and attachments. After you capture, the panel stays open so you can see the confirmation and click Review or Undo.

Below the composer, Jump to Note searches every vault and shows the top five matches. Open App brings the main window forward. If you use the app lock, the panel is locked too.

Find it The Header Quick Capture icon in the menu bar

The header:// links

For launchers, scripts and other apps

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://daily opens today's daily note, creating it from your template if needed.
  • header://today opens Today.
  • header://capture opens Quick Capture.
  • header://ask opens Ask Header.
  • header://search?q=words opens search, filled in with q if you give it.
  • header://open?note=Lisbon%20trip opens a note by title, alias or file name, the same way a [[link]] resolves. file= and title= work in place of note=.
  • header://new?title=…&content=… creates a note at the top of the open vault and opens it. Without content, the note starts with the title as a heading.
  • header://canvas creates a new canvas; header://canvas?file=Boards/Plan.canvas opens one by its path inside the vault.
  • header://manuscript opens Manuscripts; add ?note= with a manuscript's path or title to open that one.
  • header://task/complete?note=…&line=…&text=… marks one open task done. note is the note's path inside the vault, line counts from 1, and text must 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

For Terminal, scripts and AI apps such as Claude, Codex and Cursor

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.