kingcharleslzy-ai/agent-soul

agent-soul は何をしますか？

AIエージェント向けの共有メモリとアイデンティティ — Gitネイティブ、セルフホスト、ベンダーロックインなし

概要

agent-soulは、AIエージェントに共有記憶と一貫したアイデンティティを提供するスキルです。Gitを基盤としているため、エージェントの状態は常にバージョン管理され、自己ホスト環境でも動作し、特定のベンダーに依存しません。

主な機能

• 永続的な記憶: エージェントが以前の対話や決定を記憶します。
• 共有アイデンティティ: 複数のエージェント間で一貫したペルソナと知識を維持します。
• Gitネイティブ: すべての記憶はGitリポジトリに保存され、履歴の追跡やロールバックが容易です。
• セルフホスト: 自分のインフラで実行でき、外部サービスに依存しません。
• ベンダーロックインなし: 主要なAIエージェントプラットフォーム（Claude Code、Cursor、Codexなど）と互換性があります。

使用方法

1. スキルをエージェントに追加します。
2. エージェントは自動的にagent-soul Gitリポジトリを作成し、管理します。
3. 記憶は以下のようなコマンドで操作できます：

# 現在の記憶を表示
agent-soul read

# 新しい記憶を追加
agent-soul write "ユーザーはPythonを好む"

# 記憶の履歴を確認
agent-soul log

設定

環境変数で動作をカスタマイズできます：

変数名	説明	デフォルト値
AGENT_SOUL_REPO	記憶リポジトリのパス	~/.agent-soul
AGENT_SOUL_BRANCH	使用するGitブランチ	main

アーキテクチャ

エージェントはSKILL.mdの指示に従い、ファイルシステム経由で記憶リポジトリと対話します。各記憶はMarkdownファイルとして保存され、Gitの標準機能で管理されます。

ライセンス

MIT