Documentation

Get up and running with PromptingBox in three steps:

1. Create an account — Sign up with email or Google. It's free during beta.
2. Create your first prompt — Click New Prompt in the sidebar, give it a title, and paste or type your content. Markdown formatting is supported.
3. Organize — Drag your prompt into a folder or add tags to keep things tidy. You can create folders and tags from the sidebar.

That's it! Your prompts are saved securely and accessible from any device.

PromptingBox is built around a powerful prompt editor that supports rich text, variables, and version tracking.

Every prompt has a title and content. You can create prompts in several ways:

• Sidebar — Click the + button or “New Prompt” in the sidebar.
• MCP — Say “Save this to pbox” in Claude.ai, Claude Desktop, Cursor, or Windsurf.
• Chrome Extension — Highlight text on any webpage and save it as a prompt.
• Templates — Browse the public template library and copy a prompt to your workspace.

The prompt editor supports:

• Markdown rendering — Write in Markdown and preview the formatted output.
• Auto-save — Changes are saved automatically as you type.
• Copy to clipboard — One click to copy the full prompt content.
• Favorite — Star prompts to find them quickly later.
• Move to folder — Drag-and-drop or use the move action to organize.

Template variables let you create reusable prompts with swappable placeholders. Wrap any text in double curly braces:

When someone uses your prompt (or a public template), they'll see input fields for each variable. Fill in the values, and the final prompt is ready to copy. Variables are automatically detected — no configuration needed.

Public templates in the library use this feature extensively. Look for the Variables badge.

Folders provide a hierarchical way to organize your prompts, similar to a file system.

• Create — Click the folder icon in the sidebar to create a new folder.
• Nest — Drag folders inside other folders to create a tree structure.
• Reorder — Drag-and-drop folders to rearrange their order.
• Rename / Delete — Right-click or use the context menu on any folder.

Each prompt can belong to one folder. Prompts not in any folder appear under “Unfiled”.

Tags add a flat, cross-cutting layer of organization. A prompt can have multiple tags.

• Add tags — Type tag names in the tag input when editing a prompt. Tags are created automatically.
• Filter by tag — Click a tag in the sidebar to see all prompts with that tag.
• Manage tags — Visit the Tags page in the sidebar to rename or delete tags globally.

Best practice: Use folders for broad categories (e.g. “Marketing”, “Engineering”) and tags for cross-cutting themes (e.g. “#email”, “#python”, “#brainstorm”).

Use the search bar at the top of the workspace to find prompts by title or content. Combine with folder and tag filters for precise results.

• Full-text search — Searches across titles and prompt content.
• View modes — Switch between grid and list views.
• Sort — Sort by date created, last updated, or title.

Every time you save a prompt, PromptingBox creates a new version. This gives you a complete history of changes.

• View history — Open a prompt and click the version history icon to see all past versions.
• Compare — Select two versions to see a side-by-side diff highlighting what changed.
• Restore — Revert to any previous version with one click.
• Version notes — Each version is timestamped so you can track when changes were made.

This is especially useful for iterating on system prompts or complex chains — you can always go back to a version that worked well.

The built-in AI optimizer analyzes your prompt and suggests improvements for clarity, specificity, and effectiveness.

How to use:

1. Open a prompt in the editor.
2. Click the Optimize button (sparkle icon).
3. Review the suggested improvements. Accept or discard.
4. The optimized version is saved as a new version, so you can always revert.

The Template Library is a curated collection of high-quality prompts organized by category. Templates are free to browse and copy.

• Browse by category — Marketing, Engineering, Writing, Education, and more.
• Filter by tags — Narrow results with tag filters like #email, #code, #brainstorm.
• Try variables — Templates with variables let you fill in values and preview the final prompt before copying.
• Copy to workspace — One click to add any template to your personal prompt library.

MCP (Model Context Protocol) lets you interact with PromptingBox directly from AI tools like Claude.ai, Claude Desktop, Cursor, Windsurf, and Claude Code CLI. Save prompts, list folders, manage tags — all without leaving your conversation.

There are several ways to get started:

• Claude.ai (Web / Cowork) — Add a connector URL in claude.ai settings. No install needed — works in the browser and in Cowork.
• Manual setup — Install @promptingbox/mcp via npm and add a JSON config for Cursor, Windsurf, or Claude Desktop.
• Claude Code Plugin — One command to install with slash commands and smart skills included.

1. Get your API key — Go to Settings → MCP Integration and create a new key. It starts with pb_.
2. Install globally:

3. Add config to your AI tool (Claude Desktop, Cursor, or Windsurf):

4. Restart your AI tool and start saving prompts with natural language: “Save this to pbox”.

For a detailed walkthrough with tool-specific instructions, see the full MCP guide.

The PromptingBox Chrome Extension lets you save prompts directly from any webpage. Select text, right-click, and save it to your PromptingBox workspace.

Key Features

• Right-click to save — Highlight any text on a webpage and save it as a prompt via the context menu.
• Quick save popup — Click the extension icon to save the current page's content or any selected text.
• Choose folder — Select which folder to save into directly from the extension popup.
• Add tags — Tag your prompt on save for easy organization later.
• Auto-detect titles — The extension suggests a title based on the page or selected content.

Installation

1. Install from the Chrome Web Store.
2. Sign in to your PromptingBox account when prompted.
3. Start saving prompts from any webpage.

API keys authenticate the MCP server and other integrations with your PromptingBox account.

Managing Keys

• Create — Go to Settings → MCP Integration and click “New Key”.
• Copy immediately — The full key is shown only once. Copy it before closing the dialog.
• Revoke — Delete a key at any time. Any tool using that key will immediately lose access.
• Multiple keys — Create separate keys for different tools or machines for better security hygiene.

Security

• All keys start with pb_ for easy identification.
• We store only a SHA-256 hash of your key — the raw key is never persisted.
• Keys are scoped to your account — they can only access your prompts, folders, and tags.
• Rotate keys regularly, especially if you suspect a key may have been compromised.

PromptingBox supports multiple AI providers for prompt optimization. Configure your preferred provider in Settings:

• System (default) — Uses PromptingBox's built-in AI. No API key required.
• OpenAI — Bring your own OpenAI API key for GPT-powered optimization.
• Gemini — Bring your own Google Gemini API key.

Your API keys are stored securely and only used for optimization requests you initiate.

• Profile — Update your display name.
• Authentication — Email/password or Google OAuth. Change password from the settings page.
• Data export — Export all your prompts as JSON from the settings page.
• Delete account — Permanently delete your account and all associated data.