Prompteka Support

Get help with Prompteka, your personal prompt library for macOS.

Table of Contents

Getting Started

Prompteka helps you organize, search, and access all your AI prompts in one beautiful macOS app.

Key Features

Frequently Asked Questions

⚠️ Q: Can I store sensitive information like passwords or cryptocurrency seed phrases?

No, we strongly recommend against storing sensitive credentials in Prompteka.

While Prompteka keeps all your data private on your Mac (no cloud sync, no external transmission), the local database is not encrypted at rest. This means:

✅ Safe to store:

❌ Do NOT store:

Additional Protection:

If you enable macOS FileVault (full-disk encryption), your data is encrypted when your Mac is powered off or locked. However, when you're logged in and using Prompteka, the database file is accessible to anyone with access to your Mac.

For sensitive credentials, use a dedicated password manager like 1Password or Bitwarden that provides encryption at rest.

Q: Where is my data stored?

All your prompts and settings are stored locally in your Mac's Application Support folder in a file called prompts.db.

Nothing is sent to the cloud or our servers. Your data stays on your device.

Q: How do I backup my prompts?

Use the Export feature to create a JSON backup:

  1. Click the Settings icon (gear) in the bottom left
  2. Click "Backup & Restore"
  3. Click "Export All Data"
  4. Choose a location to save your backup file

We recommend backing up regularly, especially before major updates.

Q: How do I restore from a backup?

To restore your prompts from a JSON backup:

  1. Click the Settings icon (gear) in the bottom left
  2. Click "Backup & Restore"
  3. Click "Import Data"
  4. Select your backup JSON file

Note: Importing will merge with existing data, not replace it.

Q: How do I explore sample prompts?

Want to see Prompteka in action? Load sample prompts instantly:

  1. Click the Settings icon (gear) in the bottom left
  2. Scroll to "Try Sample Data"
  3. Click "Load Sample Data"

Note: This will replace all existing data with sample prompts. Make a backup first if you have prompts you want to keep!

Q: Can I sync between multiple Macs?

Prompteka doesn't have built-in cloud sync (to protect your privacy), but you can manually sync:

  1. Export your data on Mac #1
  2. Transfer the JSON file to Mac #2 (via AirDrop, iCloud Drive, USB, etc.)
  3. Import the data on Mac #2
Q: How do I copy a prompt to use with AI tools?

Click any prompt to view its full content. The entire body is automatically copied to your clipboard when you select a prompt. Just paste (Cmd+V) into ChatGPT, Claude, or any other tool.

Q: How do I organize prompts with folders?

Create folders to group related prompts:

  1. Click "New Folder" in the left sidebar
  2. Name your folder (e.g., "Marketing", "Code", "Research")
  3. Drag and drop prompts into folders
  4. Or edit a prompt and select a folder from the dropdown
Q: What are the emoji categories?

Prompteka includes 300+ emojis across multiple categories including:

Use emojis to visually distinguish different types of prompts at a glance.

Q: Can I customize the app's appearance?

Yes! You can:

Q: Are there any storage limits?

Prompteka uses a local SQLite database with no hard-coded limits. Your practical ceiling is your Mac's available disk space. However, here are some guidelines for optimal performance:

Recommended Usage (Smooth Performance)

Extended Usage (May Experience Slowdowns)

Power User Territory (Potential Performance Issues)

Why these limits?

While SQLite can technically handle terabytes of data, Prompteka loads all prompts into memory for fast searching and instant access. Very large libraries increase memory usage and slow down startup, search, and backup/restore operations. For most users managing AI prompts, these limits are more than sufficient.

Tips for Large Libraries

MCP Integration

Prompteka now supports the Model Context Protocol (MCP)—a standard way to connect AI assistants to your prompt library. With MCP, your AI tools can read, create, and organize prompts directly from conversations.

Q: What is MCP?

MCP (Model Context Protocol) is an open standard developed by Anthropic that allows AI assistants like Claude Desktop, Cursor, and other MCP-compatible tools to access external data sources—like your Prompteka library.

What you can do with MCP:

Learn more: Prompteka MCP Integration Page

Q: How do I install the MCP server?

The Prompteka MCP server is available via npm. Here's how to set it up:

  1. Install Node.js (if you don't have it): Download from nodejs.org
  2. Install the MCP server:
    npm install -g prompteka-mcp
  3. Configure your AI tool: Add the server to your MCP client's configuration (Claude Desktop, Cursor, etc.)

Detailed setup instructions: GitHub Repository README

Q: Which AI tools support MCP?

MCP is an open standard, so any MCP-compatible tool can connect to Prompteka. Popular options include:

Check your AI tool's documentation to see if it supports MCP integration.

Q: MCP integration not working?

If your AI tool can't connect to Prompteka via MCP, try these steps:

  1. Verify installation: Run prompteka-mcp --version in Terminal to confirm it's installed
  2. Check configuration: Make sure your MCP client's config file points to the correct server path
  3. Restart your AI tool: Close and reopen Claude Desktop, Cursor, or your MCP client
  4. Check permissions: Ensure Prompteka has created the database at ~/Library/Application Support/prompteka/prompts.db
  5. Review logs: Check your MCP client's logs for connection errors
  6. Refresh Prompteka app: If you have the Prompteka app open and made changes via MCP, click the "Refresh" button in the top toolbar (or press ⌘R) to see the latest data

Still having issues? See the MCP Troubleshooting Guide or contact support.

System Requirements

Troubleshooting

App won't open or crashes on launch

Try these steps:

  1. Restart your Mac
  2. Make sure you're running macOS 10.15 or later
  3. If the issue persists, contact support (see below)

Data disappeared after update

Your data should persist across updates, but if you're missing prompts:

  1. Check your backup files if you created any
  2. Look for backup files in your Documents folder
  3. Contact support with details about when the data went missing

Search looks for matches in:

Make sure your search term matches the text you're looking for. Search is case-insensitive.

Permission errors when exporting or backing up

If you see a permission error when trying to save files (exports, backups, etc.), this is macOS protecting certain system folders. Here's how to fix it:

Why This Happens

macOS protects folders like Documents, Desktop, and Downloads from apps accessing them without explicit permission. App Store apps need special entitlements to access these locations.

The Solution: Use Your Home Directory

  1. Create a new folder in your home directory (e.g., "Prompteka-Backups")
  2. When saving files, choose this folder instead
  3. This avoids all permission issues

How to Create a Folder in Your Home Directory

  1. Open Finder
  2. Press Shift+Cmd+H to go to your home folder
  3. Press Shift+Cmd+N to create a new folder
  4. Name it something like "Prompteka-Backups"

Protected vs. Safe Locations

Need More Help?

Can't find the answer you're looking for? We're here to help.

Email: support@prompteka.net

We typically respond within 24-48 hours.

Prompteka v1.6.2