Perenna

---

AI エージェント向けの、軽量で Git を基盤とする永続メモリです。Claude Code、Codex、 ChatGPT、Cursor、その他の MCP クライアントは、ベンダーアカウントや会話履歴を 共有せずに、永続的なメモリを共有できます。

• メモリの読み取り、書き込み、削除に使う個別の MCP ツール
• ローカル stdio、ループバック限定の Streamable HTTP、OAuth で保護されたリモート HTTP
• 独立した Git リポジトリに保存される、人が読める Markdown
• Git からいつでも再構築できるローカル Vexor 検索インデックス
• 複数のローカルエージェントプロセスに対応するプロセス間ロック

Perenna を選ぶ理由

メモリは、今使っているエージェントではなく、あなたについてくるべきです。

Claude Code、Codex、Cursor、ChatGPT は、それぞれ別々の場所にメモリを保存します。エージェントを切り替えると、 メモリが失われます。マシンを切り替えると、ローカルのメモリは元のマシンに残ります。

Perenna を使えば、それらのエージェントがGit を基盤とする共有メモリを使えます。ローカルエージェントと ChatGPT は 同じセルフホスト可能な Perenna サービスに接続でき、永続的なメモリはすべて、内容を確認、編集、バージョン管理し、 自分でバックアップできる通常の Markdown のまま保存されます。

Perenna は永続メモリに特化しています。アカウント、プロプライエタリなメモリクラウド、会話の自動抽出は必要ありません。

クイックスタート

AI エージェントを使ってインストールする

Claude Code、Codex、ChatGPT Desktop、Cursor、またはターミナルとローカル MCP 設定にアクセスできる 別のコーディングエージェントに、以下を貼り付けます。

Open the following URL, read the complete instructions, and follow them to
install and connect Perenna:
https://raw.githubusercontent.com/scarletkc/Perenna/main/docs/guides/agent-installation.md

公開リリースをインストールする

Perenna には Python 3.12 以降、Git、 uv が必要です。

Perenna をインストールする

uv tool install perenna

検索を設定する

Perenna には、動作する Vexor 埋め込みプロバイダーが必要です。対話形式でプロバイダーを選択、設定するには、 次のコマンドを実行します。

uvx vexor init

Perenna は ~/.vexor/config.json を自動的に再利用します。プロセス単位の設定を使う場合は、MCP サーバーに VEXOR_CONFIG_JSON と、ホスト環境の VEXOR_API_KEY または選択したプロバイダーのキーが渡されるようにしてください。 リモートプロバイダーには、メモリのテキストと検索クエリが送信されます。

ローカル埋め込みを選ぶ場合は、Perenna のローカル用追加パッケージもインストールしてください。

uv tool install "perenna[local]"

Vexor プロバイダーの設定 では、リモートとローカルの設定方法を説明しています。MCP クライアントを起動する環境から、 選択したプロバイダーが使えることを次のコマンドで確認します。

uvx vexor doctor

クライアントを接続する

スタンドアロン構成の場合、MCP クライアントが次を起動するように設定します。

perenna mcp

正確なクライアントコマンドまたは設定ファイルについては、 クライアント設定ガイド を参照してください。

Codex と Claude Code では、オプションのメモリ動作スキルもインストールできます。

perenna skill install --agent codex
# or
perenna skill install --agent claude-code

両方のクライアントにスキルを追加する場合は、1 つのコマンドで --agent を繰り返します。 設定リファレンス では、ユーザーとプロジェクトのスコープ、インストール先、置換時の保護機能について説明しています。

Codex と Claude Code では、Perenna のリポジトリ Marketplace から、スキルと MCP 接続を組み合わせてインストールすることもできます。 プラグイン設定ガイド に従い、クライアントごとにいずれか 1 つの設定方法を選択してください。

別のホームディレクトリが設定されていない限り、Perenna はローカルデータを ~/.perenna/ に作成します。

オプションの Git 同期を追加する

プライベート Git リポジトリを通じて、互換性のある履歴をインポート、公開、または早送りで更新するには、次を実行します。

perenna sync setup <repository-url>

設定が成功すると、選択したリモートが Perenna のホームディレクトリに保存されます。 Git リモートを削除せずに、保存済みのローカル専用モードに戻すには perenna sync disable を使用します。

設定リファレンス では、リモートの選択、認証情報、競合処理、復旧の詳細を説明しています。

ソースからインストールする

git clone https://github.com/scarletkc/Perenna.git
cd Perenna
uv tool install .

ソースコードへの貢献者は、 開発ガイド に記載されているロック済み環境を使用してください。

ドキュメント

まず ドキュメントのインデックス を確認し、次に目的に合った項目を参照してください。

• はじめに
• クライアント設定
• プラグイン設定
• セキュアな MCP トンネル
• ChatGPT 向けセルフホスティング
• 永続メモリの使用
• perenna-memory エージェントスキル
• 設定リファレンス
• アーキテクチャ
• 開発ガイド

ライセンス

MIT