Docs

InstallationGlobal shortcutOptimization stylesVerbosity modesLicense activationCloud routing (Cloud tier)Local Ollama setup
Documentation

PromptCraft docs

Everything you need to set up and get the most out of PromptCraft.

Installation

  • Download the latest .dmg from the Releases page on GitHub.
  • Open the .dmg and drag PromptCraft.app to your Applications folder.
  • Launch PromptCraft. macOS will ask to open an app from an identified developer — click Open.
  • Grant Accessibility permission in System Settings → Privacy & Security → Accessibility.
  • The PromptCraft crosshair icon appears in your menu bar. You are ready.

Global shortcut

  • The default shortcut is ⌘⇧Space. It toggles the app from anywhere on macOS.
  • You can change the shortcut in Settings (gear icon in the header bar).

Optimization styles

  • Each style shapes how the 7-stage pipeline assembles the final prompt.
  • General — balanced, works for most requests.
  • Engineering — adds role specification, constraints, format requirements, test stubs.
  • Research — academic framing, source awareness, structured sections.
  • Content — narrative structure, audience tone, SEO awareness.
  • Analysis — analytical frameworks, hypothesis testing, structured conclusions.
  • Academic — formal register, citation structure, methodology.
  • Creative — open-ended framing, voice latitude, inspiration triggers.
  • Custom — define your own template and it appears in the pill row.

Verbosity modes

  • Concise — strips preamble, requests direct answers, limits response length.
  • Balanced — default. Preserves full context, standard response length.
  • Detailed — requests step-by-step reasoning, examples, edge cases.

License activation

  • After purchase, a license key in the format PC-XXXX-XXXX-XXXX-XXXX is delivered to your email.
  • Open PromptCraft → Settings → Enter License Key.
  • Pro licenses activate on up to 3 Macs. Cloud on up to 5.
  • To transfer to a new machine, deactivate from the old one in Settings → Deactivate.

Cloud routing (Cloud tier)

  • Cloud subscribers can route prompts to Claude, GPT-4o, DeepSeek, or Gemini without entering API keys.
  • Select the cloud provider in Settings → AI Provider → Cloud.
  • Cloud routing uses our proxy at promptcraft-cloud-proxy.ozzydev.workers.dev.
  • Your optimized prompt is encrypted in transit. We do not log prompt content.

Local Ollama setup

  • Install Ollama from ollama.ai and pull a model: ollama pull llama3.2
  • In PromptCraft Settings → AI Provider → Local, set the base URL to http://localhost:11434.
  • Select your model from the dropdown.
  • All processing stays on your Mac. Nothing leaves your machine.