gancho

Gancho（スペイン語で「フック」の意味）は、Appleプラットフォーム向けに開発されたMITライセンスのローカルファーストなクリップボード履歴およびキュレート済みスニペットライブラリです。READMEによると、現在はアクティブに開発中のパブリックv0.8.3であり、バージョン1.0を目指しています。macOSを主要な開発環境とし、拡張機能をサポートするiPhone/iPadアプリ、計画中のvisionOSビルド、およびピン留めと最近のアイテムに限定したwatchOSをサポートしています。Android、Windows、Linuxについては将来的な分析対象としてのみ記載されており、実装の確約はされていません。 macOSでのキャプチャとプライバシーは、適応型低電力ポーリングを使用するペーストボードモニターによって処理されます。これは画面ロック時やプライベートモード時に一時停止し、自身の書き込みを抑制し、ユニバーサルクリップボードのアイテムにフラグを立て、テキスト、RTF、HTML、画像、ファイルURLなどのリッチなペイロードを保持します。ConcealedType、TransientType、AutoGeneratedTypeとしてマークされたペーストボードタイプは、コンテンツが読み取られる前にキャプチャが拒否されます。また、プリロードされたパスワードマネージャーや銀行の拒否リストに加え、「次のコピーを無視」するアクションも含まれています。デバイス上の検出器がカード番号（Luhn）、AWS/Stripe/GitHub/Slackキー、PEMキー、およびパスワードと思われる文字列を検出し、有効期限付きのマスクされたプレビューを表示します。iOS、iPadOS、visionOSでは、バックグラウンドでのポーリングは行われず、意図的なキャプチャのみが行われます。プロジェクトの方針として、クリップボードの内容がログ、テレメトリ、クラッシュレポート、分析、またはサポートバンドルに書き込まれることはありません。 ストレージにはGRDB/SQLiteが使用されており、コンテンツアドレス方式のディスクブロブ、遅延読み込みサムネイル、ページングされたメタデータのみのリスト、バージョン管理されたマイグレーション、デバイスを意識した重複排除、およびJSON/CSVエクスポートを備えています。検索はFTS5ベースで、完全一致、曖昧検索、正規表現モードに加え、種類、ソースアプリ、日付によるフィルタリングが可能です。これは10万アイテムのパフォーマンスハーネスによってサポートされています。512次元のデバイス内埋め込みインデックスが「Ask your clipboard」機能と自動ボード提案を駆動し、メインの履歴検索はFTS5のままとなります。保持エンジンは、グローバルおよび種類ごとの有効期限、機密情報の自動有効期限、およびバックグラウンドでのパージを適用しますが、ピン留めされたアイテムは除外されます。 macOSアプリはメニューバーエージェントとして動作し、サイズ変更可能なフローティング履歴パネル（Shift-Cmd-V）、キーボード優先のタイプトゥサーチ、合成可能なフィルタ、編集可能なタイトル、種類ごとのプレビュー、読み取り専用のフルコンテンツプレビュー、および合成Cmd-Vによるペーストバック機能を備えています。ピン留め、複数メンバーシップのボード、ボードとスニペットのための統合ライブラリが実装されており、スタックへの一括追加、ボードへの追加、元に戻す機能付きの削除、複数選択、ファイルクリップのドラッグ、構造的な編集を伴うSpotlightへのキュレートされた寄贈、および読み取り専用プレビュー、検証、アトミックな重複排除、キャンセル機能を備えたガイド付きMaccy/CSV履歴インポートが提供されます。Raycastはインポートソースから明示的に除外されています。これは、ドキュメント化されたクリップボードAPIが最近の6つのエントリしか公開しておらず、暗号化されたバックアップにサードパーティ向けの復号スキーマが記載されていないためです。 iPhoneおよびiPadアプリでは、「保存」ボタン、UIPasteControl、共有拡張機能、App Intents/ショートカットを通じた意図的なキャプチャのみを提供します。さらに、履歴付きのキーボード拡張機能、ウィジェット、iPadのSplit View、ソースアプリフィルタリングを備えています。デバイス上のインテリジェンススタックはネットワークなしで動作し、5ms未満で17種類のコンテンツを認識する決定論的なティア0分類器、Apple Intelligenceによるタイトル生成、スクリーンショットOCR、セマンティックインデックス、Dev Actions（JWTデコード、JSONフォーマット、Base64、URLパース、色変換、UUIDフォーマット。これらはApp Intentsとしても公開）、Smart Pasteによる書き換え/翻訳/PII（個人識別情報）編集、履歴に基づいた根拠のあるQ&A、および自動ボード提案を提供します。各ステージはインテリジェンス画面のトグルで切り替え可能です。 同期には、SyncEngine境界を介してユーザーのプライベートiCloudデータベース上で動作するCKSyncEngineが使用され、同期ステータスが可視化されています。統合機能には、gancho CLI、期限付きで取り消し可能なクライアントごとの権限を持つローカルのオプトインMCPサーバー（明示的なボード/時間コンテキスト、独立した読み書き権限、メタデータのみのアクセスログを備える）、およびVS Codeの「Save Selection」コマンドが含まれます。収益化にはStoreKit 2の購入、復元、権限管理が組み込まれており、コンテキストに応じたペイウォールと無料プランの制限が設けられています。直接ダウンロード版のビルドでは、支払いシークレットを埋め込むことなくLemon Squeezyを通じてProライセンスの購入、有効化、再検証、無効化が可能であり、Proプランで暗号化されたiCloud同期がアンロックされます。オプションの匿名診断は明示的な同意があるまで無効のままであり、プライバシーセンターのアクティビティレシートは、同期やエクスポートを行うことなく、デバイス上でアプリごとの合計値を13ヶ月間のローリング期間で保持します。 エンジニアリング面では、XcodeGen、Swift 6の厳格な並行性（strict concurrency）、英語/スペイン語のバイリンガルString Catalogゲート、アクセシビリティサポートを使用し、8つのライブラリ製品とCLIを含む単一のSwiftPMパッケージ（GanchoKit）で構成されています。CIはビルド、テスト、リントをカバーし、本番ソースのカバレッジ下限の強制、シリアル化されたStoreKitオートメーション、およびスケールパフォーマンスを検証します。ビルドにはmacOS 15.4+、Xcode 26+、およびXcodeGenが必要であり、テスト、iOSデバイスへのインストール、パッケージング、リリースQA、サイトチェックのためのmakeターゲットがドキュメント化されています。READMEでは、基盤となるオープンソースワークとしてGRDB.swift、SQLCipher、KeyboardShortcuts、Sauce、TelemetryDeckに謝辞が述べられています。ライセンス：MIT、© 2026 Johnny Young。