Documentation

Step-by-step guides for every part of PromptMason. New to it? Start with Your first prompt.

Download every guide as one Markdown file (.md)

Get started

Install PromptMason, set it up, and make and copy your first prompt.

  • Your first prompt: Install PromptMason, see how your 14 days of Pro and the license key work, make your first block, build a prompt from it and copy it.
  • Install, update and remove: Install PromptMason on Windows, start your 14 days of Pro, update to a new version, and remove it.
  • A tour of PromptMason: What each part of the PromptMason window is for, and the few ideas everything else builds on.
  • Show or hide features: Turn PromptMason's optional features on or off, so the app shows only what you use.

Blocks, prompts and documents

Write blocks, put them together into prompts, fill in variables, and copy the result.

  • Create and edit blocks: Write reusable pieces of prompt text, change them, copy them and see which prompts use them.
  • Build a prompt: Put blocks together on the Build screen, check the result in the preview, and save it as a prompt.
  • Static prompts, dynamic prompts and documents: Understand the three kinds of prompt, how each one behaves when a block changes, and how to write and edit each one.
  • Library blocks and embedded blocks: Choose between a block you can reuse in any prompt and a block that belongs to one prompt only, and edit either from the Build screen.
  • Copy and use a prompt: Find a saved prompt, fill in its values, copy it into your AI tool, and fix the warnings a prompt can show.
  • Variables: Save a value once, such as your company name, and use it in any block or prompt, or have PromptMason ask for it each time you copy.
  • Formatting, block headers and hidden notes: Format the text of blocks and prompts, control the header lines between blocks, and leave notes that never reach the AI.
  • Markdown documents and Skills: Write, save, copy and download Markdown documents, such as Skills, on the Build screen.
  • Edit a prompt as code: See a dynamic prompt's blocks written out as text, copy them, and edit them directly in the Code view.
  • Add a block pack: Add a ready-made set of blocks, prompts and variables to your library, from the app or from a file downloaded from the website.
  • Version history: See the earlier versions of a block, prompt or document, and restore one.
  • Comments: Add, edit and delete comments about a block, prompt or document in the Comments panel.
  • Expected output: Keep the results an AI tool gave for a block, prompt or document, with the tool and model that gave them.

Find and organize

Search, filter, file and tidy your blocks and prompts as your library grows.

  • The Home screen: Turn on Home, search everything from it, and add, arrange and set up its widgets.
  • Find anything: Search your whole library from Home, search and filter each screen, find a setting, and sort what you see.
  • Explorer: See your blocks, prompts and folders in one place, and open, move, copy, file and delete them.
  • Folders, moving and copying: Make folders, file your blocks and prompts in them, and move or copy items and whole folders.
  • Tags, favorites and ratings: Label items with tags, mark favorites with a heart, rate them with stars, and filter by all three.
  • Archive, delete and restore: Put blocks and prompts away with Archive, delete them, bring them back, or delete them for good.

AI in PromptMason

Use AI to improve your text, grade it, and run your prompts, with the local model or your own AI provider.

  • Set up AI: the local model or your own key: Choose what AI assist, Evaluate and Chat use, add an API key or your own server, and pick the default.
  • Free, private AI on your PC: the local model: PromptMason includes an AI model that runs on your own PC, free on every plan, with no API key or account. Download it, make it your default, and fix download or start-up problems.
  • Improve text with AI assist: Ask AI to rewrite or draft a block, static prompt or Markdown document while you edit it, and review the suggestion before you keep it.
  • Evaluate a block, prompt or document: Get a score and suggestions for a saved block, prompt or Markdown document, or check it for private details before you share it.
  • Run prompts in Chat: Chat with the local model or your own AI provider, run your saved prompts in the conversation, and keep, rename or delete your chats.
  • Chat and context: What each chat message sends, how long chats are handled with the local model and with a cloud provider, and where your chats are kept.
  • Web tabs: Open AI websites such as Claude or ChatGPT in tabs on the Chat screen, put a prompt in the site's message box, and manage bookmarks, history and sign-ins.
  • Customize the AI instructions: Read and change what PromptMason tells the AI for AI assist, Evaluate and Chat, preview exactly what's sent, and export or import your instructions.
  • What AI features send, and where: See exactly what each AI feature sends, who receives it and when, and what PromptMason keeps on your computer.

MCP and connected apps

Use your blocks and prompts from your AI apps through PromptMason's built-in MCP server, or from any website with the Chrome extension, and control what they can do.

  • PromptMason's built-in MCP server: What the MCP server inside PromptMason does, which AI apps can use it, what they can do in your library, and how you stay in control.
  • Connect an AI agent through MCP: Add PromptMason to Claude Desktop, Cursor or Claude Code, and understand the security notice Claude Desktop shows.
  • Control what connected apps can do: Choose Full access, Read-only or Off for AI agents and the Chrome extension, set what AI apps can do in a team library, and manage the tokens they use.
  • MCP tools: what an AI agent can do: Everything a connected AI agent can find, use and change in PromptMason, what works in Read-only, and requests you can try.
  • The Chrome extension: Install the PromptMason extension for Chrome, connect it with the extension token, and search and copy your prompts on any website.
  • Troubleshooting MCP connections: What to do when adding PromptMason to your AI agent doesn't finish, or your AI agent reports a problem with PromptMason.

Libraries, sync and backups

Use your library on more than one PC, share it with a team, and keep backups.

  • Personal and team libraries: Switch between your libraries, move items from one library to another, and read who made each change and how each library is syncing.
  • Backups: Turn on automatic backups, choose where they go, and restore a library from a backup.
  • Use your library on a second PC: Sync your personal library to your other PCs, or add another of your PCs to a team library.
  • Team libraries: Create a team library, choose its shared folder, invite people, and understand the roles.
  • Approve a PC: Approve someone joining a team library, or a member's new PC, by comparing the approval code.
  • Remove a person or a PC: Remove someone from a team library, or one of their PCs, then remove them from the folder's sharing.
  • The primary owner: What only the primary owner can do, their approving PC, and handing the role to another owner before time away.
  • Sync problems: What each sync message in PromptMason means, and what to do about it.
  • Notifications: Read and act on PromptMason's notifications about backups, your recovery kit, and the libraries you sync or share.

Privacy, security and recovery

Where your data is kept, how it is protected, when anything leaves your PC, and what to do if you lose a PC.

Settings, plans and data

Find any setting, understand the Free and Pro plans and your license key, and move your data in and out.

  • Plans and limits: What the Free and Pro plans include, what counts toward the Free limits, and what happens when you reach them.
  • Your trial and license key: How your 14 days of Pro work, buy and activate Pro, move a key to another PC, and fix license messages.
  • When your library is paused: Why PromptMason pauses your library on the Free plan, what still works, and the three ways to unpause it.
  • Export and import: Save your personal library to a file, add a file's contents to your library, or replace your library with a file.
  • Settings reference: Find any setting in PromptMason, see what it does and its default, and go to the guide that explains it.
  • Keyboard shortcuts: See every keyboard shortcut in PromptMason, change any of them, and put them back to the defaults.
  • Block types, prompt types and defaults: Add your own block and prompt types, and set how far back Recent looks and how blocks are written into a prompt.

Troubleshooting and reference

Fix common problems, look up a term, and find out how to get help.

  • Troubleshooting: Common problems in PromptMason, what each message means, and what to do about it.
  • Glossary: The words PromptMason uses, each explained in a line or two, with a link to the guide that covers it.
  • Get help: Ways to get help with PromptMason, and what to include when you email support.