PromptPanel(项目快贴) 是一款开源、原生的 macOS Prompt 管理工具 和 snippet launcher。它围绕一条很短的 AI 工作流设计:在任何前台应用中按快捷键,搜索本地 Prompt 库,按 Enter,内容先写入系统剪贴板,再尽力自动粘贴进当前输入框。没有账号、没有云同步、没有遥测,核心数据留在你自己的 Mac 上。

In English: PromptPanel is a native macOS prompt manager, AI prompt launcher, and local-first snippet manager for people who reuse prompts and templates across ChatGPT, Claude, Cursor, Copilot, VS Code, Terminal, browsers, and other macOS text fields.

如果你正在搜索 ChatGPT Prompt 管理 macOS、Claude Prompt 库、Cursor 代码片段管理器、本地优先 Prompt 库、macOS global hotkey paste tool、Raycast Snippets alternative for AI prompts 或 open-source TextExpander alternative for multiline prompts,PromptPanel 对应的就是这个需求:把重复输入的 AI 指令、代码片段和项目上下文变成一个本地、可搜索、可审计的快捷面板。

PromptPanel exists because the same five problems show up every day for anyone working with LLMs:

• You retype the same role / system prompt ("you are a senior staff engineer...") into a fresh ChatGPT or Claude chat ten times a day.
• You keep a Notes app or scratchpad full of AI prompts and code-review checklists and ⌘+F your way through it.
• You finally find the right prompt and the paste fails silently because focus moved or the app blocked synthetic keystrokes.
• Your Cursor / Copilot project context block is in one file, the terminal command snippet in another, and the PR-review prompt in a third — none searchable from one place.
• You won't put a real client brief or proprietary architecture into a cloud prompt manager, so you end up with no prompt manager at all.

PromptPanel collapses all of that into a single, sub-second loop with a local SQLite file you fully own.

Most "prompt managers" are either browser extensions (locked to one site), or generic snippet tools that weren't built for the AI workflow. PromptPanel is purpose-built around one short loop:

hotkey → search → enter → content lands in the active input field

Everything else is in service of making that loop fast, predictable, and never lossy.

• Heavy ChatGPT / Claude / Gemini users who reuse the same role definitions, output-format constraints, and context blocks
• Cursor / Copilot / Aider users who paste the same architecture summaries and review checklists
• Developers who repeatedly type commit-message scaffolds, code review templates, terminal commands, error-triage snippets
• Indie hackers and consultants juggling multiple client projects with different style guides and tone-of-voice rules
• Technical writers and PMs who maintain reusable replies, status updates, and spec scaffolds

If "I copy and paste the same multiline prompt twenty times a day" describes you, this tool was written for you.

• 🔥 Global hotkey — summon the panel from any foreground app, configurable shortcut
• ⚡ < 300 ms time-to-input — NSPanel-based, no Electron, no web runtime, no cold start
• 🔍 Instant search across title and body, no submit step
• 🗂️ Projects — isolate prompts per client, repo, or context; Universal project always visible
• 📋 Auto-paste with clipboard fallback — uses CGEvent to send ⌘V, falls back gracefully if Accessibility permission is missing
• 🎯 Keyboard-first — arrow keys to navigate, Enter to execute, Esc to dismiss
• 📌 Pin & sort — pin frequent entries, manual sort, then by recency, then by usage count
• 🌗 Light / dark / system theme
• 🪶 Menu-bar resident — out of the way until you summon it
• 🚀 Launch at login via SMAppService
• 🔐 Permission-aware degradation — without Accessibility, you still get one-key copy and a clear UI hint
• 📝 Multiline content — full template bodies, no length limit on storage
• 📊 Execution log for diagnosing paste failures
• 🔄 Manual update via GitHub Releases (Sparkle auto-update is wired in but ships off-by-default; the maintainer will enable it once a signed appcast feed is hosted)

By design PromptPanel will never add cloud sync, team collaboration, or complex workflow orchestration. These are not "later" — they are out of scope forever. The tool is a single-user, local-only utility, and that is the point. See PRD §4.2 for the rationale.

 ┌──────────────┐ hotkey ┌──────────────┐ select ┌──────────────┐
 │ any app │ ──────────► │ PromptPanel │ ──────────► │ clipboard │
 │ (ChatGPT, │ (global) │ NSPanel │ (Enter) │ (write) │
 │ Claude, │ │ │ └──────┬───────┘
 │ Cursor...) │ ◄──────────── │ │ │
 └──────────────┘ paste / focus└──────────────┘ │
 ▲さんかく restored │
 └────────── CGEvent ⌘V (Accessibility permission) ◄───────────┘
 fallback: clipboard only + toast

1. You press the configured hotkey (KeyboardShortcuts library captures it system-wide).
2. PromptPanel snaps an NSPanel over the active window, focuses the search field, and shows entries from the current project plus the Universal project, sorted by pin → manual → recency → usage count.
3. You type to filter (live, no submit), arrow to choose, press Enter.
4. The selected content is always written to the system clipboard first (this is the guarantee — clipboard never silently fails).
5. The panel hides, the previous app regains focus, and PromptPanel synthesizes a ⌘V via CGEvent. If Accessibility permission is missing or the target app blocks synthetic events, a toast tells you "Copied — press ⌘V to paste."
6. Execution is logged locally so you can diagnose any per-app paste issue later.

This separation — clipboard as guarantee, auto-paste as best-effort — is the single most important design decision in the project.

System requirement: macOS 14 (Sonoma) or later. Apple Silicon and Intel both supported.

# 1. Clone
git clone https://github.com/tytsxai/PromptPanel.git
cd PromptPanel
# 2. Build the .app bundle (signed ad-hoc by default)
./scripts/build-app.sh
# 3. Move it into Applications (or run from dist/)
open dist/PromptPanel.app

Requirements for building:

• Xcode 15+ with the macOS 14 SDK
• Swift 5.10 toolchain (xcrun swift --version)

GitHub Releases currently carry source/documentation release notes only; no notarized binary asset is attached yet. Until the Developer ID notarization chain is complete, build locally with ./scripts/build-app.sh.

1. Grant Accessibility permission when prompted. macOS uses this to allow synthetic ⌘V keystrokes. Without it, PromptPanel still copies to clipboard reliably; you just paste manually.
2. Set your hotkey in Settings → Hotkey. The current default is ⌥2; pick another shortcut if it conflicts with your setup.
3. Create a project or start adding entries to Universal.

1. ⌥2 → panel appears, search field focused
2. type "review" → filters to your code-review prompt
3. ↵ → content pasted into the active text field
4. (panel hides) → keep working

You can switch the active project from inside the panel without opening the main window — keyboard-only, no detour.

• Local-first by definition. Your prompts live in a single SQLite file on your Mac. The app does not POST your content anywhere.
• No telemetry. No analytics SDKs, no metrics endpoints, no crash reporting service.
• Network access is zero in the current release. Sparkle is bundled but the update feed is not configured, so no outbound calls happen at all unless a future build ships with an appcast.
• No accounts. There is nothing to sign in to.
• Open source. Audit Sources/PromptPanel/Core/ to verify any of the above.

If your prompts contain proprietary information — internal architecture, client briefs, NDA-bound context — this is exactly the property you want.

Quick orientation, not a takedown. These tools are good at what they do.

TL;DR: if you live in the browser only, a browser extension is fine. If you live in Cursor/VS Code/Terminal/Slack/everywhere, you want something native and panel-based. Among native panel-based options, PromptPanel is the open-source, AI-prompt-shaped one.

Concrete ways people use PromptPanel day-to-day — these double as the long-tail "how do I..." questions PromptPanel is built to answer.

• Spin up a fresh ChatGPT / Claude chat with your standard role / system prompt. Hotkey → type role → Enter. No more retyping "You are a senior staff engineer who..." for the 200th time.
• Drop a Cursor / Copilot project-context block into a new file. Have a multi-paragraph "here is the architecture, conventions, and constraints" block stored once; paste into any new Cursor session with one keystroke.
• Paste a code-review checklist into a PR draft. Long bulleted checklist lives in PromptPanel; one hotkey appends it to a GitHub PR description.
• Fire a repeating terminal command with the exact flag combo. kubectl get pods --context=prod --namespace=... -o jsonpath=... — typed once, stored, summoned by short search string.
• Insert a meeting-notes template into Notion / Obsidian / Apple Notes. Same template every Monday standup → one hotkey, zero copy-paste from a Notes app scratchpad.
• Push a customer-service / sales reply template into Slack or email. Different tone per template, picked from a quick-search panel rather than a Notes folder.
• Switch between projects with isolated prompt sets. Each project group keeps its own role prompts, snippets, and templates so context never bleeds across clients.

• Language: Swift 5.10
• UI: AppKit (NSPanel, NSStatusItem) + SwiftUI
• Storage: SQLite via GRDB.swift
• Hotkey: sindresorhus/KeyboardShortcuts (Carbon Hot Key under the hood)
• Auto-paste: CGEvent synthesizing ⌘V after focus restoration
• Login item: SMAppService
• Updater: Sparkle 2
• Distribution: Developer ID + Apple notarization (no Mac App Store)
• Build: Swift Package Manager — no Xcode project required

See docs/技术选型.md for the full decision log.

PromptPanel/
├── Sources/PromptPanel/
│ ├── App/ # AppDelegate, AppState, lifecycle
│ ├── Core/
│ │ ├── Database/ # SQLite open / migrate / recover
│ │ ├── Repositories/ # Project, Entry, Settings, Log
│ │ ├── Services/ # PanelService, ExecuteService, SearchService...
│ │ ├── Diagnostics/ # Hotkey-to-focus timing
│ │ └── Utils/
│ ├── Integrations/ # Clipboard, Paste (CGEvent), Tray, Hotkey, Updater
│ ├── Features/
│ │ ├── Panel/ # QuickPanelView + ViewModel — the hero feature
│ │ └── MainWindow/ # Library + Settings
│ └── Resources/ # Info.plist, entitlements, AppIcon, Assets
├── Tests/PromptPanelTests/
├── frontend-draft/ # UI source-of-truth (HTML/JSX mockups + screenshots)
├── scripts/ # build-app.sh, notarize, release readiness, restore
├── docs/ # public architecture, FAQ, PRD, release, ops, handoff docs
├── .github/ # contribution, security, conduct, issue/PR templates, CI
├── llms.txt # short AI-search / LLM-readable project index
├── codemeta.json # structured open-source software metadata
└── Package.swift # SwiftPM package definition

The public documentation set is part of the repository:

• Documentation index
• FAQ
• Product PRD
• Project introduction
• Architecture
• Core modules and logic
• API and feature contract
• Configuration
• Deployment
• Development standards
• Usage examples
• Operations and troubleshooting
• Maintainer handoff guide
• Docs/code sync matrix
• Release and recovery
• Roadmap and contribution guide
• AI search and discoverability
• Full LLM context
• Search metadata JSON-LD
• Contributing
• Security
• CodeMeta software metadata

For answer engines and repository-aware AI tools, start with llms.txt or the expanded llms-full.txt.

PromptPanel keeps classic SEO and GEO surfaces in-repo so users and answer engines can identify the project accurately:

• README.md and README.zh-CN.md give the human landing-page summary and current screenshots.
• llms.txt is the short AI-readable index for repository-aware tools.
• docs/ai-search/llms-full.txt is the expanded answer-engine context with FAQ-style answers.
• codemeta.json and Schema.org JSON-LD describe the app for software catalogs, search crawlers, and future docs-site publishing.
• AI search and discoverability defines the canonical wording, search-intent map, and maintenance checklist.

PromptPanel follows a deliberately small roadmap. The PRD lists items that are explicitly off the table forever (cloud sync, teams, workflow orchestration). Within scope:

• v1.0 — main link complete: hotkey → search → execute, projects, clipboard fallback, light/dark, login item, Sparkle, signing & notarization scripts
• JSON / Markdown import & export, with automatic backup before import
• One-tap "repeat last entry"
• Variable templates ({{name}} style) — only if it can be added without slowing the main link

See docs/路线图与贡献指南.md for prioritization rules, CHANGELOG.md for what's shipped, and issues for public planning.

For a longer FAQ, see FAQ.md. The greatest hits:

Yes. MIT license. No paid tier, no usage cap, no account.

Yes — it builds as a universal binary. Tested on both Apple Silicon and Intel macOS 14+.

No. The current release makes zero network calls. Sparkle is bundled but the update feed is not configured in this build, so no outbound traffic happens at all. Your prompt content never leaves your Mac.

To synthesize a ⌘V keystroke after the panel hides and your previous app regains focus. Without this permission the app still works — it just stops at the clipboard step and shows you a "press ⌘V to paste" toast.

No, deliberately. Those are listed as permanent non-goals in the PRD §4.2. The product's identity is "single-user, local-only, fast." Adding any of those would change what the product is.

The hottest paths in this product (global hotkey timing, focus restoration, synthetic keystroke injection, accessibility permission flow) are macOS system-integration concerns. A cross-platform shell adds latency and indirection without buying any features that matter for this product. See docs/技术选型.md for the full reasoning.

Open an issue: https://github.com/tytsxai/PromptPanel/issues. Please use the templates — they'll save us both round-trips.

Use Settings → Maintenance → Import JSON for full PromptPanel library transfers, or Import MD for Markdown prompt collections. Imports automatically create a local database backup first. Export JSON is best for lossless migration; Export MD is best for reviewable sharing.

PRs welcome — please read CONTRIBUTING.md first. Two non-obvious rules:

1. UI changes must align with frontend-draft/. That directory is the source of truth for visuals; don't ship a Swift view that contradicts the JSX mockup.
2. Stay inside the PRD's scope. If a proposal would push the product toward cloud / teams / workflows, it's a "no" regardless of how well-implemented it is. This isn't gatekeeping — it's the reason the tool is fast and trustworthy.

PromptPanel stands on:

• GRDB.swift by Gwendal Roué
• KeyboardShortcuts by Sindre Sorhus
• Sparkle by the Sparkle team

...and the broader Swift / AppKit community whose docs and Stack Overflow answers made the system-integration paths possible.

MIT © 2026 tytsxai and PromptPanel contributors.

_{Keywords (so you can actually find this when you search): macOS prompt manager · AI prompt launcher · ChatGPT prompt manager macOS · Claude prompt library · Cursor snippet manager · Copilot prompt template launcher · open-source TextExpander alternative · Espanso alternative · Raycast snippets alternative · Alfred snippet replacement · global hotkey paste macOS · local-first prompt library · offline AI prompt storage · native Swift NSPanel app · AI workflow productivity tool · prompt template manager macOS · snippet launcher macOS · keyboard-first prompt picker · LLM prompt library Mac · prompt engineering toolkit macOS · Cursor prompt manager · fast local prompt launcher for AI · NDA-safe prompt storage.}

Star History Chart