PromptBranch

---

PromptBranch は、AI プロンプトの作成、整理、テスト、改善を行うためのシンプルなローカルファーストの場所です。プロンプトを自分のコンピューターに保存して、変更履歴を追跡し、さまざまな AI モデルで実行して、お気に入りの AI ツールと連携できます。データは自分で管理でき、保存する前に変更を確認して承認できます。

警告

開発中です。 PromptBranch は現在も活発に開発されています。バグや未実装の動作が見つかる場合があり、開発の進行に伴って機能が変更されることがあります。 セキュリティに関する問題以外の報告をお願いします。 セキュリティ上の懸念は、セキュリティポリシーを通じて非公開で報告してください。

機能

プロンプトライブラリを構築

• 📚 タグ、コレクション、お気に入り登録、フィルター、全文検索（⌘K）、履歴とメモ、JSON のインポート／エクスポート、自動ローカルバックアップを使って、プロンプトを整理できます。
• 📋 PromptBranch の実行中に、オプションのクイックアクセスパレット、設定可能なグローバルショートカット、変数入力、正確なテキストプレビューを使って、別のアプリからプロンプトをコピーできます。
• 🌿 ブランチ、安定したバージョン ID、既存バージョンの更新と新規保存、履歴ラベル、変更メモ、差分、バリエーションを使って、バージョンを追跡できます。
• 🧪 4 つの評価軸による評価、結果の実行ログ、並べての比較、LLM による判定、評価サマリーで、結果を評価できます。

AI やエージェントで実行

• ⚡ models.dev を利用したカタログを使って、OpenAI、Anthropic、Google、および OpenAI 互換エンドポイントの複数モデルで実行できます。暗号化された API キーとトークン／コストの追跡に対応し、最大 6 つのモデルを同時に実行できます。
• 🤖 同じライブラリを使う CLI と MCP サーバーを通じて、エージェントと連携できます。エージェントは実行結果やメモを報告したり、バリエーションを提案したりできます。人間が内容を確認して承認します。

自分の希望に合わせて共有、同期

• 🔗 推測困難な URL で不変のスナップショットを共有したり、ウェブサイトにアクティブな共有を埋め込んだり、公開されている Markdown URL を確認してインポートしたりできます。共有には、公開前のシークレットスキャン、取り消し可能なリンク、専用の共有ビューが含まれます。
• 🔄 ローカルネットワーク上のデバイス間で直接同期できます。短い確認コードでペアリングすると、変更はまずローカルに保存され、デバイス同士が接続可能になったときに自動で反映されます。

インストール

PromptBranch デスクトップ版は、macOS、Windows、Linux で利用できます。 お使いのオペレーティングシステム用のインストーラーを GitHub Releasesからダウンロードしてください。

CLI と MCP サーバーもクロスプラットフォームに対応しています。セットアップ方法や ソースからのビルドについては、 インストールガイドをご覧ください。

データの保存場所

デスクトップアプリ、CLI、MCP サーバーはすべて同じデータベースを開きます。

プラットフォーム	パス
macOS	~/Library/Application Support/PromptBranch/library.db
Linux	$XDG_CONFIG_HOME/promptbranch/library.db
Windows	%APPDATA%\PromptBranch\library.db

PROMPTBRANCH_DB=/path/to.db を設定すると、任意のエントリーポイントで別のライブラリを指定できます（個人用やテスト用のライブラリなど）。 プレリリース版（PromptBuilder または PromptHub という名前）をお使いの場合、アプリは初回起動時に既存のライブラリを新しい場所にコピーし、元のライブラリはそのまま残します。

デスクトップアプリを開いたまま CLI や MCP サーバーを実行しても安全です。これらはデータベースファイルを共有しています。ウィンドウにフォーカスすると、アプリは新しい実行結果、メモ、評価、提案を取り込みます。

エージェント連携

AI コーディングエージェントは、CLI と MCP サーバーという 2 つの薄いアダプターを通じて、アプリの UI と同じセマンティクスでライブラリを操作します。基本ルールはエージェントが提案し、人間が承認することです。エージェントはプロンプトを読み取り、実行やメモを報告し、バリエーションを提案できますが、提案されたバリエーションは保留中のバージョンとして作成され、検索や一覧には表示されません。また、アプリのSuggestionsビュー（左側のレールにあり、保留中の件数バッジが表示されます）で人間が承認するまで、現在のバージョンにはできません（承認時に現在のバージョンとして設定することもできます。却下すると、永久に非アクティブのままになります）。

オンボーディングはコピー＆ペーストで完了します。Settings → Agent integration を開くと、解決済みの DB パスと、すぐに貼り付けられる MCP クライアント設定を確認できます。npm パッケージには、コーディングエージェントに fetch → report → suggest のワークフローを教えるオプションのスキルファイルも含まれています。

MCP サーバー

@promptbranch/mcp は npm から利用できます。次の設定で、stdio に対応した任意の MCP クライアントから接続します。

{
  "mcpServers": {
    "promptbranch": {
      "command": "npx",
      "args": ["-y", "@promptbranch/mcp@latest"]
    }
  }
}

ツール：get_prompt、search_prompts、list_prompts、report_run、add_note、suggest_variation。プロンプトはタイトル（完全一致、大文字と小文字を区別しない一致、次に一意の部分一致の順。曖昧な場合は近い候補を返します）または ID で参照します。suggest_variation は保留中の提案を返します。人間に Suggestions ビューを開いて確認するよう伝えてください。

CLI

CLI を使うと、シェルのパイプラインから同じ操作を利用できます。グローバルにインストールせずに、公開パッケージを npx -y @promptbranch/cli@latest として実行するか、npm install -g @promptbranch/cli@latest でグローバルにインストールして、短い promptbranch コマンドを使用できます。すべてのコマンドで、機械可読な出力を得るために --json を指定できます。

promptbranch list --tag security
promptbranch get "security-audit" > /tmp/prompt.md
promptbranch search "sql injection"
promptbranch report-run --prompt "security-audit" --tool kimi-cli --model k2 --outcome 4 --summary "found 2 issues"
promptbranch add-note --prompt "security-audit" --body "works well on small diffs"
promptbranch suggest --prompt "security-audit" --file improved.md --rationale "tighter scope"
promptbranch suggestions   # pending review queue
promptbranch db-path       # prints the resolved database path

共有は人間のみが行えます。publish と import はここおよびデスクトップアプリでのみ利用できます。ライブラリにインターネット上のコンテンツを取り込む MCP ツールは、意図的に用意していません。

AI プロバイダー

PromptBranch は、実際のモデルに対してプロンプトを実行し、AI を使ってプロンプトの下書きや改善を行えます。対応プロバイダーは、OpenAI、Anthropic、Google、およびカスタムのベース URL を使った任意のOpenAI 互換エンドポイント（Ollama、LM Studio、など）です。

セットアップは 1 ステップです。Settings → AI Providers → Connect a provider を開き、API キーを貼り付けます。PromptBranch はオペレーティングシステムの安全な認証情報ストレージを使ってキーを暗号化し、モデルへのリクエスト時にのみ復号します。接続時に自動で接続テストが行われ、モデルカタログはバックグラウンドで更新されます。環境変数に OPENAI_API_KEY、ANTHROPIC_API_KEY、または GOOGLE_GENERATIVE_AI_API_KEY が設定されている場合、PromptBranch はそのプロバイダーへの接続時に、ワンクリックで使える Use environment key を提示します。

接続すると、そのプロバイダーのカタログにあるすべてのモデルをすぐに利用できます。Settings でモデルを選択する手順はありません。モデルは Run ボタンの横にある検索可能なモデルピッカーから選択します（入力中に絞り込み、プロバイダーごとにグループ化され、コンテキストウィンドウや料金のヒント、プロンプトごとの最近使用したモデルが表示されます）。個々のモデルは、ピッカーにカーソルを合わせたときの操作で非表示にできます。それ以外はそのまま使えます。OpenAI 互換エンドポイントにはカタログがないため、モデル ID はプロバイダーの設定行に直接記述します。

モデルカタログは models.dev から取得され、ローカルにキャッシュされます。閲覧と編集はオフラインでも行えますが、カタログの更新、モデルの実行、共有にはネットワークが必要です。カタログの更新に失敗した場合は、古いキャッシュの提供を続けます。

各 Run は、プロンプト（{{variable}} の置換後）を最大 6 つのモデルに対して同時に実行し、モデルごとに 1 件のエントリを記録します。エントリには、プロバイダー、モデル、ステータス、出力またはエラー、レイテンシ、トークン使用量、カタログの料金に基づく推定 USD コストが含まれ、比較ビュー用にまとめられます。

共有

スナップショットは不変で、公式ポータル https://promptbranch.app 上の、推測できない /p/<id> URL で公開されます。

• 公開は、プロンプトツールバーの共有ダイアログから行います（公開範囲の選択、公開前のシークレットスキャン、送信内容のプレビュー）。削除トークンはローカルに保存されるため、後から左側のレールにある共有ビューで共有を取り消せます（検索、ステータスによる絞り込み、リンクのコピー、取り消し、取り消し済みエントリーの削除）。
• インポートは、promptbranch://import?url= のディープリンクまたは promptbranch import で行えます。スナップショットは、タグと出所に関するメモを含む新しいローカルプロンプトになります。共有履歴はポータル上で引き続き閲覧できますが、ローカルのバージョンチェーンとして再作成されることはありません。
• ウェブサイトへの埋め込みには、アクティブな共有のためにコピーできる HTML を使用します。コピー時に「Auto」「Light」「Dark」を選択できます。「Auto」は訪問者のシステムの外観設定に従います。プロンプトは iframe を使わず Shadow DOM に表示され、タイトルとPromptBranch で開くボタンが表示されます。ポータルのスクリプトはホストページ上で実行されるため、信頼できるポータルの埋め込みコードのみを使用してください。HTML スニペットと CSP の要件については、共有ガイドを参照してください。
• 公開 Markdown リンクには promptbranch://import-markdown?url= を使用します。デスクトップアプリは、ユーザーがMarkdown を取得を選択した後にのみコンテンツを取得し、新しいローカルプロンプトを作成する前にプレビューを表示します。ソースには、公開 HTTPS 経由でアクセスできる必要があります。共有ガイドには、ウェブサイトの所有者がコピーしてカスタマイズできる HTML ボタンの例も記載されています。

複数デバイス間の同期

サーバーもアカウントも使わずに、自分のコンピューター間でライブラリを直接同期できます。デバイスは mDNS を使ってローカルネットワーク上で互いを検出し、ワンタイムペアリングコードで認証して、相互にピン留めした TLS 経由でレコード単位の差分を交換します。設定 → 同期で有効にすると、左側のレールのフッターにあるステータス行で、同期済み／同期中／デバイスを待機中の状態をひと目で確認できます。

• 仕組み：アプリ、CLI、MCP サーバー（同じデータベースファイルを共有しています）のいずれから行われた変更も、論理クロックのリビジョンとともにローカルの操作ログに記録されます。ピアは不足している操作を交換し、決定論的にマージします。独立して作成されたレコードは ID によって統合され、同じレコードへの変更は最終書き込み優先で解決されます。同じ名前のタグ／コレクション／ブランチは 1 つの行に統合されます。プロンプトを同時に編集して別々に保存すると両方のバージョンが作成されますが、同じバージョンへの同時の修正は決定論的に解決されます。
• 信頼性：各デバイスには自己署名証明書があります。8 文字のペアリングコードは、接続を受け入れるデバイスの証明書フィンガープリントから生成されるため、ネットワーク上に中間者がいるとコードが一致しません。デバイスを削除すると、そのデバイスのピン留めは永久に解除されます。API キーがデバイスの外に出ることはなく、設定も意図的にデバイスごとに分けられています。共有レコードも同期されるため（削除トークンを含む）、ペアリング済みのどのマシンからでも共有を管理し、取り消すことができます。
• 接続範囲：デバイスが同じネットワーク上にあるとき（または VPN を利用しているとき）に同期されます（設定 → 同期 → デバイスを追加でアドレスを指定してペアリングします）。デバイスが離れている間、変更は待機します。変更は書き込まれた時点で永続化されるため、「アップロード待ち」になることはありません。
• macOS に関する注意：最初の同期セッションで、システムのローカルネットワークのアクセス許可を求めるプロンプトが表示されます。許可しないと、ペアリングとデバイスの検出でピアを認識できません。

ドキュメント

docs/でドキュメント全文をご覧ください。

まずはこちら	さらに詳しく
概要と理念	プロンプト管理
インストール	検索、整理、クイックアクセス
クイックスタート	ライブラリデータとバックアップ
基本概念	マルチモデル実行
MCP サーバー	LLM 評価
CLI	AI アシスト
AI プロバイダー	ピアツーピア同期
リンク共有	設定と環境
アップデート

貢献をご希望ですか？CONTRIBUTING.mdをご覧ください。

ライセンス

PromptBranch はMIT ライセンスのもとで公開されています。アプリに同梱されているサードパーティソフトウェアは THIRD_PARTY_NOTICES.mdに記載されており、 アプリ内の概要 → オープンソースライセンスからも確認できます。