How can we help?

Download the latest release from the Prompto website, then drag the app into your Applications folder. Launch it once — macOS may ask you to confirm an app downloaded from the internet.

Prompto runs in your menu bar, not the Dock. Look for the small chevron icon in the top-right of your screen. If you don't see it, try the troubleshooting section.

Prompto opens with ⌘⇧P by default. To change it, click the menu bar icon → Settings → Shortcut, then press your new combination.

Avoid shortcuts already used by the system (like ⌘Space for Spotlight) or your most-used apps. Popular alternatives: ⌃Space, ⌥P, or a Hyper key combo.

Open Prompto and press ⌘N, or click the + button in the top-right. Give it a title, paste the prompt body, and optionally add tags.

A good prompt has a clear title (you'll search by this), a short description (shown in the list), and well-structured body text. Use newlines generously — they preserve on paste.

Settings → Library → Import. Prompto reads plain JSON or a folder of markdown files where each filename becomes a title.

For Notion, Obsidian, or Raycast snippets, export to markdown first. We'll auto-detect tags from frontmatter.

Just start typing. Prompto matches against titles, descriptions, and tags. Results are ranked by how often and how recently you've used each prompt.

Use ↑↓ to move, ⏎ to copy, or ⌘⏎ to copy and auto-paste into the previously focused app.

Tags are lowercase single words (or hyphenated). Add them when editing a prompt. To filter, type #tagname in the search bar, or press ⌘T to open the tag picker.

Stack tags to narrow results: #swift #review shows only prompts with both.

Wrap placeholders in double curly braces: {{topic}}. When you copy a prompt with variables, Prompto opens a small form asking for each value, then fills them in before copying.

Variables support defaults too: {{tone=professional}}.

Press ⌘D on any selected prompt to pin it. Pinned prompts always appear first, regardless of search ranking.

Prompto is flat by design — no folders. Use tags instead. Most people settle on 5–10 tags that map to domains (code, writing, email) and roles (review, draft, brainstorm).

Prompto has no cloud. To sync, move your library file into iCloud Drive, Dropbox, or a git repo, then point each Mac at the same file in Settings → Library → Location.

Another app is probably using the same combo. Try a different shortcut in Prompto's Settings, or check System Settings → Keyboard → Keyboard Shortcuts for conflicts.

Prompto also needs Accessibility permission to listen for global shortcuts. Go to System Settings → Privacy & Security → Accessibility and make sure Prompto is enabled.

If your menu bar is crowded, icons can get hidden behind the notch. Hold ⌘ and drag the Prompto icon to reorder it, or quit some other menu bar apps.

“Copy and auto-paste” (⌘⏎) uses Accessibility permission to simulate ⌘V. Verify Prompto is allowed in System Settings → Privacy & Security → Accessibility.

Your library lives at ~/Library/Application Support/Prompto/library.json. Prompto keeps the last 14 daily snapshots in the same folder — restore from there first.

If you moved the file to iCloud Drive, check that iCloud finished syncing on that Mac.

Settings → Advanced → Reset. This clears preferences but keeps your library. To also reset the library, delete ~/Library/Application Support/Prompto/ and relaunch.