Help

Detailed documentation for Thoughts, the macOS app for capturing and organizing your thoughts.

v 1.0 Updated June 2026 10 sections ~ 8 min read
01 — Getting started

Install & open

Two steps from download to your first note. Thoughts lives in the menubar — always one click away.

  1. Open the Thoughts .dmg file you downloaded, then drag the Thoughts app icon into your Applications folder.
  2. Launch Thoughts from Applications. The app lives in your menubar — look for the smiley face icon and click it to open the popover.
Thoughts menubar icon
The Thoughts icon in your menubar. Click it anytime to open the app.
02 — Capture

Text notes

Click What's on your mind? and start typing. The input box expands as you write.

Thoughts main window with empty state
The main Thoughts window before you capture your first note.

Card menu

Press / to open the card menu. From there you can insert:

  • Text — a regular paragraph
  • Image — an inline image block
  • Checklist — tickable to-do items
  • Unordered list — a bulleted list
  • Code — a code block
Slash menu showing Text, Image, Checklist, Unordered List, and Code options
Press / to choose a block type. Use the formatting toolbar for bold, italic, strikethrough, and quick inserts.

While you write

  • Shift + Enter — new line, or a new checklist item inside a checklist
  • Enter — new paragraph
  • Backspace icon (top right of the composer) — clear the whole draft
  • + Enter — save the note, or click Save
  • + B, + I, and + + X — bold, italic, and strikethrough
  • + C, + X, and + V — copy, cut, and paste
03 — Capture

Voice notes

Press the microphone button next to the text field, then talk. The button turns red while you are recording. Press the red stop button (square icon) to finish.

Active voice recording with waveform and timer
While recording, you will see a live waveform and timer.

In Settings → Capture, choose the correct Microphone, set Max recording, and adjust Playback volume. Turn on Auto-transcribe audio notes if you want a transcript added automatically when you save a voice note (requires an AI API key — see below).

Capture settings for microphone, volume, and transcription
Pick your input device and transcription options under Capture.
04 — Capture

Image notes

Pin the app first (pin icon in the top right), then drag an image into the What's on your mind? box or anywhere in the main app body. You can also use the image button beside the microphone, or insert an image block with /.

Tip: Pin the app before you drag images in. Pinning keeps Thoughts open and floating above other windows, which makes drag-and-drop much easier.

Pinned Thoughts window with an audio note and transcription
When pinned, Thoughts stays on screen and shows a banner: “App pinned — stays above other windows.”
05 — Library

Your notes

Saved notes appear in your feed, grouped by day (for example, Today). Each note card has a footer with the time and action icons.

Note footer with time, export, share, and detail arrow
From left to right: timestamp, export, share, and the detail arrow.

Detail view

Click the small arrow (>) in the note footer to open the detail view. Tap Actions at the bottom to see everything you can do with that note (AI tools, export, and more).

Share & delete

  • Share (square with arrow) — send text notes to Notes, Messages, Mail, and other macOS share targets.
  • Export (download icon) — save that note in the best format (text, image, MP3, or PDF).
  • Delete (trash icon) — click once to arm delete, then click Confirm to remove the note permanently.

You can also export all notes at once from Settings (see Data below).

06 — AI

AI setup

Thoughts does not run AI through a shared account. You connect your own provider so transcription, OCR, rewrites, and translations use your API key. Keys are stored locally on your Mac only.

Add your API key

  1. Open Thoughts and click the gear icon (Settings) in the top right.
  2. Scroll to the AI section.
  3. Choose your AI provider: OpenAI, Gemini, or Claude.
  4. Paste your API key into the field. It is masked like a password. Settings auto-save — look for Auto-save on in the footer.
Settings showing General and AI sections with API key field
Settings → AI: pick a provider and paste your key. The note under the field reads “Required for AI features. Stored locally only.”
AI provider dropdown with OpenAI, Gemini, and Claude
Supported providers: OpenAI, Gemini, and Claude.

Where to get a key

  • OpenAI — create a key at platform.openai.com/api-keys. Keys usually start with sk-. Used for transcription (Whisper), text actions, and image text extraction.
  • Gemini — create a key in Google AI Studio. Keys often start with AIza. Supports transcription and text actions.
  • Claude — create a key in the Anthropic Console. Keys usually start with sk-ant-. Great for text rewrites; voice transcription requires OpenAI or Gemini, not Claude.

Related settings

  • Translation → Default target language — default language for the Translate action on text notes. You can still pick another language per note in the Actions menu.
  • Capture → Auto-transcribe audio notes — when on, new voice notes get a transcript automatically (OpenAI or Gemini key required).
  • Capture → Transcription language — Whisper hint when not set to Auto-detect; also biases image text extraction.
07 — AI

AI actions

With a valid API key, open any note's detail view and expand Actions. Available actions depend on the note type.

Text notes

Shorten

Tightens your note while keeping the meaning — useful for long drafts.

Lengthen

Expands brief notes with more detail and context.

Summarize

Produces a shorter summary of the note content.

Fix spelling

Corrects spelling and typos without changing your tone unnecessarily.

Translate

Rewrites the note into another language. Pick from the language list, or use your default from Settings.

Convert case

Changes letter casing: UPPER CASE, lower case, Title Case, or Sentence case.

Convert to Text

For notes that contain images: extracts text from embedded images and turns the note into readable text (OCR).

Image & voice notes

  • Image notesExtract Text pulls text out of the image; Convert to Note turns it into an editable text note; Summarize gives you a short summary of extracted content.
  • Voice notesTranscribe creates or refreshes a transcript; Convert to Note turns the recording into an editable text note; Summarize summarizes the transcript.

In the detail view for image notes, use Actions → Extract Text (or the image-to-text flow above) to change an image into editable text when AI is enabled.

09 — Shortcuts

Keyboard shortcuts

+ Enter — save the current note.

+ B, + I, and + + X — bold, italic, and strikethrough.

+ C, + X, and + V — copy, cut, and paste.

+ H — hide Thoughts.

+ Q — quit Thoughts.

You can set a custom App Shortcut under Settings → General to open Thoughts from anywhere (default is often + + T).

10 — Configuration

Settings

Open Settings with the gear icon. Changes save automatically.

General

Choose your theme (Auto, Light, or Dark), whether Thoughts opens on startup, mascot expressions, the global app shortcut, and what happens when you double-click the menubar icon — start a New Recording or a New Text Note.

AI

Pick your provider and paste your API key. See AI setup for where to get a key and which features each provider supports.

Translation

Set the default target language used by the Translate action on text notes. You can still choose a different language per note in the Actions menu.

Capture

Choose your microphone, playback volume, maximum recording length, whether new voice notes are auto-transcribed, and the transcription language hint.

Data

Export notes downloads everything as JSON. Quit Thoughts fully exits the app ( + Q works too). In the Danger Zone, Delete all removes every note after you confirm.

Data settings with Export, Quit, and Delete all
Settings → Data: export everything, quit, or delete all notes.