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 a folder of Markdown files where each filename can become a title.

For Notion, Obsidian, or Raycast snippets, export to markdown first, then import or select that folder as your vault.

Just start typing. Prompto matches against titles, prompt bodies, and tags, with title matches ranked first so short queries stay predictable.

Use ↑↓ to move and ⏎ to copy the selected prompt to the clipboard.

Tags are lowercase single words (or hyphenated). Add them when editing a prompt. Search can match tags directly, alongside titles and prompt bodies.

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

Create, edit, and delete prompts inside the launcher panel. Prompto keeps the same Markdown-backed vault structure, so the files remain readable outside the app.

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 manually, move your vault folder into iCloud Drive, Dropbox, or a git repo, then point each Mac at the same folder 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.

Install the Direct DMG, open Prompto, then enter the license key from your Lemon Squeezy receipt when Prompto asks for activation. Activation needs a network connection.

After activation, Prompto stores local licensing state in Keychain so the Direct app can keep working offline while the certificate remains valid.

Open Lemon Squeezy My Orders with the email address used at checkout. Lemon sends a secure magic link and shows your order history.

If you cannot access that email, contact hello@jnjambrino.com with the order ID if available, approximate purchase date, and the last four characters of the license key. Do not send the full key.

If the old Mac is available, open Settings → License and choose Deactivate. Then activate the new Mac with the same Direct license key.

If the old Mac was replaced, wiped, or lost, contact support. Include the order ID, checkout email, and last four license-key characters, but do not send prompt files or raw device IDs.

The launch Direct license is for 1 Mac. This message usually means the license is still active on another Mac. Deactivate the old Mac first, or contact support if you no longer have access to it.

First-time activation needs the licensing service. Once activated, Prompto Direct can keep working offline with its local certificate while that certificate remains valid. Refresh the license later from Settings → License when the network is available.

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.

Direct downloads default to ~/Documents/Proxima Prompt Vault. The Mac App Store build defaults to its sandboxed Application Support vault. Check Settings → Library for the currently selected vault path.

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

Settings → Advanced → Reset. This clears preferences but keeps your vault. To also reset the vault, choose a new empty vault folder in Settings → Library.