Persome

Personal Model：コーディングエージェント向けのローカルファースト AI メモリー

_{自動再生プレビュー · 高画質デモと v0.3.2 のリリースノート}

HUMAN.md を作成しましょう — Claude Code、Codex、Cursor Agent、その他の信頼できる MCP クライアント向けに、証拠に紐づいた1つの Personal Model を作成できます。

Personal Model はオープンソースのローカルファーストな長期メモリーランタイムです。macOS の許可を与えた後、Mac 上で記録された対象を絞ったアクティビティから、あなたの思考や仕事の進め方を学習します。そして、AI ツールが作業を続け、根拠に基づいた判断を行うための、検証可能なコンテキストを提供します。

Mac 上でローカルに動作します。デフォルトでプライベートです。確認、修正、エクスポート、削除はあなた自身で行えます。

Personal Model をインストール · AI ツールを接続 · GitHub で Personal Model にスターを付ける

成熟した Personal Model の概念図。

---

Personal Model を選ぶ理由

Personal Model は、使用するアプリでの対象を絞ったアクティビティをポータブルなコンテキストレイヤーに変換し、Mac 上に保持して、選択した信頼できる AI クライアントから利用できるようにします。

• エージェント間で共有できる1つのメモリー。 同じ Personal Model を Claude Code、 Codex、Cursor Agent、その他の MCP 対応クライアントに接続できます。
• 隠れた要約ではなく、証拠を提供。 重要な主張には元の記録が残ります。 新たな証拠によって、以前の推論を補強、修正、または覆すことができます。
• ユーザーが所有する設計。 ホスト型メモリーサービスに依存せずに、モデルと データを確認、修正、エクスポート、削除できます。
• チャット履歴だけではありません。 macOS の権限を明示的に許可した後に、 対象を絞ったアクティビティから Personal Model が学習します。

あなたの Personal Model があなたの HUMAN.md です

Personal Model はアクティビティをつなぎ、段階的に深いコンテキストへと発展させます。

レイヤー	意味
Point	出典のある観察や出来事
Line	関係性や時間の経過に伴う変化
Face	関連する証拠によって裏付けられたパターン
Volume	プロジェクトや生活領域をまたぐ、より高次の構造
Root	あなたについて現在統合されたモデル

その結果、今何が重要なのか、どのように判断する傾向があるのか、 そして注意の向かう先がどこへ移っているのかを表す、生きたモデルが得られます。

Claude Code、Codex、Cursor Agent、MCP クライアントに対応

クライアント	接続方法	セットアップ
Claude Code	Personal Model ネイティブインストーラー	persome install claude-code
Codex CLI と IDE 拡張機能	Personal Model ネイティブインストーラー	persome install codex
Cursor Agent CLI	Personal Model ネイティブインストーラー	persome install cursor-agent
Claude Desktop	管理対象の stdio 設定	persome install claude-desktop
opencode	管理対象のローカル stdio 設定	persome install opencode
その他の互換クライアント	生成された MCP JSON	persome install mcp-json --filename persome-mcp.json

MCP クライアントガイドでは、前提条件、検証、 権限の境界、トランスポートの詳細、HTTP フォールバック、トラブルシューティングについて説明しています。

Personal Model は、信頼できる MCP クライアントが使用する MCP サーバーです。Filesystem、GitHub、Slack、Google Drive などの他の MCP サーバーは、別個のツールであり、 その連携機能が明示的に構築され、テストされていない限り、Personal Model の連携機能ではありません。

ユースケース

これらのビジュアルは、Personal Model によって可能になるエージェントのワークフローを示しています。Runtime は MCP を通じて、根拠に紐づいたローカルコンテキストを提供します。接続されたエージェントはタスクの選択と実行を担い、外部アクションには引き続きユーザーの許可が必要です。

1. ひとつの Root — あなたのモデル

何千もの瞬間。進化し続ける、あなたのモデル。

Personal Model は、情報源のある観察事項を関係性、パターン、より高次の構造、そしてひとつの現在の Root へと変換します。今何が重要なのか、どのように判断する傾向があるのか、関心がどこへ向かっているのかを示します。

Points から Lines、Faces、Volumes、そしてひとつの Root へ――あなた自身と、今何が重要なのかを表す、生きたモデルです。

2. 同じ AI。異なるあなた。

モデルは同じです。理解する相手は異なります。

2 人が同じ AI に同じプロンプトを入力しても、それぞれ異なる回答がふさわしい場合があります。Personal Model は、エージェントが優先順位を決め、判断し、文章を書き、行動する方法を変えます。誰のために働いているのかを理解できるからです。

同じプロンプトから、誰に対しても同じ回答が生成されるべきではありません。AI にあなたのモデルを与えましょう。

3. ひとつの MCP — コーディングエージェントを能動的なエージェントに

コーディングエージェントが、自ら作業を見つけます

MCP を通じて Personal Model に一度接続すれば、Codex、Claude Code、その他の信頼できるエージェントが、目標、優先事項、作業パターン、境界についての同じモデルを利用できます。

接続されたエージェントは Personal Model を検索して未完了の作業を見つけ、提案する次のステップを優先事項に照らして順位付けし、ローカルでの実装と、承認が必要な外部アクションを区別できます。

中断したところから再開

#### 眠っている間も作業

インストール、接続、検証

Personal Model をインストールし、信頼できる MCP クライアントを接続して、ローカルの Runtime を検証します。

1. データとともにインストール

要件：macOS 13 以降、および Xcode Command Line Tools。パッケージ管理を利用した最短のインストール方法：

uv tool install personal-model
persome onboard
persome model open --after 30

配布パッケージ名は personal-model、インストールされる CLI は persome です。

ソースから初回実行する場合の、最も明示的な方法：

git clone https://github.com/Intuition-Lab/personal-model.git
cd personal-model
bash install.sh

対話形式のオンボーディングが正常に完了すると、ソースインストーラーによって統合された ローカルセットアップ画面がすぐに開きます。

オンボーディングで確認されること

• persome onboard は、各 macOS の許可要求が表示される前に内容を説明します。
• アクセシビリティはバージョン管理された mac-ax-helper に付与され、イベント駆動型のキャプチャが有効な場合に限り mac-ax-watcher にも付与されます。
• 画面収録は、実効スクリーンショットポリシーまたはローカル OCR ポリシーでピクセルデータが必要な場合に限り要求されます。Personal Model がフルディスクアクセスを必要とすることはありません。
• Apple Silicon では、ローカル OCR に同梱の PP-OCRv6 を使用します。Intel では macOS の Apple Vision フレームワークを使用します。オンボーディングでは、どちらのアーキテクチャでも分離されたワーカーを検証します。
• 統合された localhost のオンボーディングでは、読み取り専用で複数ソースからデータをインポートし、既存の Markdown 履歴から最初のモデルを構築できます。 ローカルフォルダーは常に利用できます。Obsidian と Notion は Mac 上で検出された場合のみ表示されます。同じソースは persome import-data からも利用できます。詳しくはインポートガイドを参照してください。
• 最終的なライフサイクルの所有者と Runtime の世代を確認したうえで、標準デーモンモードでは新しいキャプチャの受領確認を報告します。また、trusted ingest などのサポートされている代替モードでは、準備状況とプライバシーの明示的な受領確認を報告します。

LLM は収集と BM25 による検索には任意ですが、セマンティックモデリングには必須です。無人処理用にホステッドまたはローカルのプロバイダーを設定できます。

persome llm setup
persome llm status --check

または、既存のコーディングエージェントのサブスクリプションをバックグラウンドの Runtime に明示的に利用させることもできます。クライアント CLI は独自のログイン情報を保持して更新します。Personal Model が保存するのは、その実行ファイルのパス、ルーティングポリシー、永続的な1日あたりの呼び出し上限のみです。

persome llm agent setup --client codex --daily-call-limit 50 --check
# also supported: claude-code, cursor-agent
persome llm status

ツールを使った Sampling をサポートする信頼できる MCP クライアントは、引き続き process_pending_model_work を呼び出して、1回のリクエストで1～10セッションを処理できます。どちらの方法でも、接続済みエージェントの利用枠を使い、OAuth トークンを Personal Model に公開しません。クライアント CLI ブリッジは、無人処理の各段階にも使用されるオプトイン方式です。

2. 信頼できる MCP クライアントを接続

使用する各クライアントを、所有者のローカル環境に登録します。

persome install claude-code
persome install codex
persome install cursor-agent
persome install claude-desktop
persome install opencode

上記のコマンドでインストールされるのは MCP サーバーのみです。バックグラウンドのセマンティック処理で、サポートされているコーディングエージェントのサブスクリプションを使用することに明示的に同意するには、--fund-model も追加してください。デフォルトの上限は、ローカルの1日あたり50回のモデル呼び出しです。

persome install codex --fund-model --daily-call-limit 50
# also supported: claude-code, cursor-agent

persome llm agent disable を実行すると、クライアントからログアウトしたり、フォールバックプロバイダープロファイルを削除したりせずに、その同意を取り消せます。

これらの stdio 登録では、MCP プロセスが必要に応じて起動されるため、オンボーディングでローカルデータベースを初期化した後は、デーモンを実行し続ける必要はありません。また、HTTP ベアラーがクライアント設定にコピーされることもありません。スキーマの作成とマイグレーションは引き続きデーモンが管理します。新規または外部でアップグレードされたデータルートでは、stdio クライアントが使用する前に persome start を1回実行する必要があります。デーモンが停止していても stdio による書き込みは利用できますが、WAL の保守はデーモンの起動中に行われます。その状態で書き込みツールを使用する場合は、WAL のサイズを一定範囲に保つため、定期的にデーモンを起動してください。

Cursor と互換性のある別の設定には、引き続き stdio オブジェクトを生成し、mcpServers.persome を手動でマージできます。

persome install mcp-json --filename persome-mcp.json

MCP へのアクセスは個人データを扱う機能です。信頼できるクライアントのみ登録してください。

3. 検証し、根拠に基づいて質問する

persome status
persome model status
persome model open

# Only if you configured a semantic provider:
persome llm status --check

初期段階では、モデルのデータが少ない、または劣化していても問題ありません。Personal Model は、Faces、Volumes、Root を捏造するのではなく、ジオメトリが欠けていることを報告します。

MCP クライアントを接続したら、次のレシピのいずれかを試してください。

Personal Model で [topic] を検索してください。search を使い、最も有力な結果を read_receipt で開き、ソースのパス、タイムスタンプ、レシート ID を引用してください。証拠が見つからない、または矛盾している場合は、推測せずにその旨を伝えてください。

[project] で中断したところから再開するのを手伝ってください。Personal Model の最近のコンテキストを検索し、観察された事実と推論を区別して、提案する次のステップの根拠となるレシートを示してください。

デフォルトの get_model_snapshot の概要を使って、現在の Personal Model を確認してください。回答に必要なモデルのセクションだけをページングし、裏付けとなる証拠を引用して、データが少ない箇所、古い箇所、または矛盾している箇所を指摘してください。

アクティブな作業は、デフォルトでは 5 分ごとに減衰します。有効なキャプチャと機能するセマンティックプロバイダーがある場合、最初に実用的なリコールが得られるまでの時間は、運用上約 10 分と見込まれます。ただし、ベンチマーク結果として保証されるものではありません。

4. Personal Model を更新する

uv tool でインストールした場合は、パッケージマネージャーを使ってアップグレードし、Runtime の検証を再実行してください。

uv tool upgrade --python 3.12 personal-model
persome onboard
persome model open --after 30

アップグレード後は、Runtime への書き込みを再開する前に、Personal Model の stdio MCP プロセスをホストしているエディターを再起動してください。以前のリリースから読み込まれたプロセスは、エディターが再接続するまで、新しいプロセス間 SQLite メンテナンスゲートに参加できません。

install.sh でインストールした場合は、任意のディレクトリからトランザクション方式のアップデーターを実行してください。

persome update

persome update は、設定、認証情報、個人データ、キャプチャポリシー、ライフサイクルの意図を保持し、更新を確定する前に、実行モードに応じたオンボーディングを独自に実行します。パッケージマネージャーで管理されているインストールの更新には使用しないでください。

---

レシピ

• Claude Code で Personal Model を使用する
• Codex CLI と IDE 拡張機能で Personal Model を使用する
• Cursor Agent で Personal Model を使用する
• Claude Desktop で Personal Model を使用する
• opencode で Personal Model を使用する
• 互換性のある MCP クライアントを接続する

上記のプロンプトとクライアントガイドを使って、インストール、接続の検証、証拠に基づく検索のテスト、権限の境界の確認、よくある問題の診断を行ってください。

Personal Model の位置付け

Personal Model は、所有者のローカル環境で動作する macOS Runtime であり、ホスト型のマルチテナントメモリーサービスでも、単なるグラフライブラリでもありません。ChatGPT や Claude の製品固有のメモリーや、開発者向けメモリーインフラストラクチャと併用できます。

ホスト型サービスまたはベンチマーク上の主張として扱う前に、Runtime の境界と評価の限界をお読みください。

プライバシー、所有権、証拠

• Personal Model は macOS 上の所有者のローカル環境で動作し、関連する権限について説明し、許可された後にのみアクティビティをキャプチャします。
• 重要なメモリーとモデルオブジェクトには来歴が保持され、信頼できるクライアントは read_receipt と resolve_evidence で確認できます。
• 修正後も監査履歴は保持されます。エクスポートはデフォルトで機密情報が削除され、履歴自体を削除する必要がある場合に使える明示的な消去コマンドも用意されています。
• MCP へのアクセスは個人データへのアクセスです。信頼できるクライアントのみを登録し、localhost の Runtime を公開トンネル経由で公開しないでください。

完全なセキュリティとプライバシーのモデル、モデルと証拠の契約、MCP ツールの契約をお読みください。

より多くの MCP クライアントのテストにご協力ください

お使いのクライアントが上記に記載されていない場合は、 汎用 MCP セットアップから始めてください。動作した場合は、クライアント名、バージョン、トランスポート、検証手順、権限に関する注意点を記載して、 issueを作成してください。手順を再現できることが確認されてから、クライアントが検証済みの表に追加されます。

開発ワークフローと DCO の要件については、CONTRIBUTING.mdをご覧ください。

---

GitHub で Personal Model にスターを付ける · 公式 MCP レジストリ · MCP クライアントのセットアップ · セキュリティとプライバシー

コントリビューター

Singularity   💻 コード	Li_Xufeng   💻 コード	Siyi   🎨 デザイン
Kevin   💻 コード	huachenjie238-oss   📈 成長	Jing@Meowy   📈 成長
Zhiheng Chen   💻 コード

## スター履歴

_{2026 年 7 月 31 日までのスナップショット · Star History で開く}