codesstar/loci

Memory Palace for AI — persistent memory, identity, and multi-project orchestration for Claude Code

Loci – AIエージェントのためのローカルメモリレイヤー

概要

Lociはオープンソースのツールで、複数のAIエージェントが共有コンテキストを読み書きできる個人用・ローカルな「脳」を提供します。すべてのデータは自分のコンピュータ上に平文のMarkdown、JSON、添付ファイルとして保存されるため、完全なコントロールを維持し、任意のエディタでデータを閲覧・編集できます。

主な機能

機能 使用方法
個人メモリ 名前、言語設定、考察、決定事項などを保存し、接続されたエージェントが後で取得できるようにします。
タスクとスケジュール ToDoアイテム、会議ノート、タイムブロックを作成します。時間が設定されたタスクもあくまでタスクであり、Lociが自動的にカレンダーに追加することはありません。
プロジェクトコンテキスト プロジェクトの状態、技術的な決定、開発チケットの軽量なインデックスをプロジェクトリポジトリ内に保持します。詳細はローカルな「脳」に残ります。
連絡先と場所 人物、関係性、過去のやり取り、場所を記録します。
ナレッジボールト リンクをブックマークし、スニペットを保存し、ファイルを添付し、自分の研究ノートをインデックス化します。
日記とレビュー アクティビティログを閲覧し、最近の作業を要約し、保存された情報をレビューします。

Lociを操作するには、システムに接続されたエージェントに自然言語コマンドを送信します。例:

以后用中文回复我。
明天上午9点提醒我发材料。
把这个链接收藏起来,标注“面试参考”。
记住这个项目,再告诉我目前做到哪里了。

エージェントはLOCI‑RULES.mdで定義されたルールに従って、これらのコマンドをファイルの読み書きに変換します。

対応エージェント

Lociは小さな「インストール」プロンプトを提供し、以下のいずれかのエージェントに貼り付けると、そのエージェントが「脳」を読み書きできるようになります:

  • Claude Code
  • Codex
  • Hermes
  • 千问工作 (Qianwen Work)
  • 豆包工作 (Doubao Work)
  • Qoder
  • WorkBuddy

プロンプトを初めて実行するときはインストールを選択します。以降のエージェントは既存の「脳」に接続するだけです。

アーキテクチャ概要

  1. LOCI.md – 短いエントリポイント – エージェントに「脳」の場所と設定の取得方法を伝えます。
  2. LOCI‑RULES.md – 完全なハンドブック – タスク、連絡先、プロジェクトなどのルールを構造化したもので、エージェントが最初に行動する必要があるときに一度だけ読み取ります。
  3. オンデマンドなデータ読み込み – リクエストに必要な情報のみが読み取られ、データセット全体がメモリに読み込まれることはありません。
  4. ダッシュボード(Node.js) – マシン上で動作するローカルなWeb UIで、エージェントを操作せずにMarkdown/JSONファイルを表示、編集、検索できます。
  5. フック – 短縮形の設定を自動的に注入するオプションのスクリプトです。存在しない場合、エージェントは汎用エントリポイントにフォールバックします。

実行方法

  • 前提条件: Node.js 18+、Git、およびエージェントがファイル/コマンド操作を実行できるローカル環境。
  • npmパッケージのインストールは不要です。リポジトリにはNodeサーバーとデータスキーマが含まれています。
  • インストールは、エージェントにdocs/AI‑INSTALL.mdをフェッチして実行させることで行われます。新しいツールを接続するにはdocs/AI‑CONNECT.mdを使用します。

データとプライバシー

すべてのレコードはファイルシステム(Markdown、JSON、添付ファイル)に残ります。バックアップ、クラウドストレージとの同期、自由な移動が可能です。Loci自体はリモートサービスにデータを送信しませんが、使用する基盤となるAIモデル(Claude、Codexなど)は、独自のポリシーに従ってプロンプトを送信する場合があります。

はじめに & 貢献

  • 完全なユーザーガイド: https://www.tryloci.com/handbook/ (または docs/user-guide.md のMarkdown版)。
  • クイックスタートドキュメント: docs/getting‑started.md (英語) / docs/getting‑started.zh‑CN.md。
  • APIリファレンス: docs/api.md。
  • サンプルブレイン: examples/alex/ にディレクトリレイアウトがあります。
  • 貢献はIssueとPull Requestで歓迎します。プロジェクトはMITライセンスです。

要約: Lociは軽量なファイルベースのメモリレイヤーで、複数のAIエージェントが自分のコンピュータ上で共通の編集可能な知識ベースを共有でき、人間の監視用にシンプルなローカルダッシュボードを提供します。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト