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

Loci – AI 에이전트를 위한 로컬 메모리 레이어

개요

Loci는 여러 AI 에이전트가 공유 컨텍스트를 읽고 쓸 수 있는 **개인용, 로컬 '브레인'**을 제공하는 오픈소스 도구입니다. 모든 데이터는 자신의 컴퓨터에 일반 텍스트 Markdown, JSON, 첨부 파일로 저장되므로 완전한 제어를 유지하고 모든 편집기로 데이터를 탐색하거나 편집할 수 있습니다.

주요 기능

기능	사용 방법
개인 메모리	이름, 언어 기본 설정, 회고, 결정 사항 등을 저장하고 연결된 에이전트가 나중에 검색할 수 있도록 합니다.
작업 및 일정	할 일 항목, 회의 노트, 시간 블록을 만듭니다. 시간이 있는 작업도 여전히 작업일 뿐이며 Loci가 자동으로 달력에 추가하지는 않습니다.
프로젝트 컨텍스트	프로젝트 상태, 기술 결정, 개발 티켓에 대한 가벼운 인덱스를 프로젝트 저장소 내에 유지합니다. 전체 세부 정보는 로컬 브레인에 남아 있습니다.
연락처 및 장소	사람, 관계, 과거 상호 작용, 위치를 기록합니다.
지식 보관함	링크를 북마크하고, 스니펫을 저장하고, 파일을 첨부하고, 자신의 연구 노트를 인덱싱합니다.
일기 및 검토	활동 로그를 탐색하고, 최근 작업을 요약하고, 저장된 정보를 검토합니다.

Loci와 상호 작용하려면 시스템에 연결된 에이전트에 자연어 명령을 보냅니다. 예:

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

에이전트는 LOCI‑RULES.md에 정의된 규칙에 따라 이러한 명령을 파일 읽기/쓰기로 변환합니다.

지원 에이전트

Loci는 다음 에이전트 중 하나에 붙여넣을 수 있는 작은 '설치' 프롬프트를 제공하며, 이후 해당 에이전트는 브레인을 읽고 쓸 수 있습니다:

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

프롬프트를 처음 실행할 때 설치를 선택합니다. 이후 에이전트는 기존 브레인에 연결하기만 하면 됩니다.

아키텍처 개요

LOCI.md – 짧은 진입점 – 에이전트에게 브레인의 위치와 기본 설정을 가져오는 방법을 알려줍니다.
LOCI‑RULES.md – 전체 핸드북 – 작업, 연락처, 프로젝트 등에 대한 규칙을 구조화한 것으로, 에이전트가 처음으로 행동해야 할 때 한 번 읽습니다.
온디맨드 데이터 로딩 – 요청에 필요한 정보만 읽으며 전체 데이터 세트가 메모리에 로드되지 않습니다.
대시보드 (Node.js) – 에이전트를 건드리지 않고 Markdown/JSON 파일을 보고, 편집하고, 검색할 수 있는 로컬 웹 UI.
훅 – 단축 기본 설정을 자동으로 주입하는 선택적 스크립트. 없으면 에이전트는 일반 진입점으로 폴백합니다.

실행 방법

사전 요구 사항: 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/에 디렉토리 레이아웃이 있습니다.
기여는 Issues 및 Pull Requests를 통해 환영합니다. 프로젝트는 MIT 라이선스입니다.

요약: Loci는 여러 AI 에이전트가 자신의 컴퓨터에서 공통의 편집 가능한 지식 베이스를 공유할 수 있게 하는 경량 파일 기반 메모리 레이어이며, 인간의 감독을 위한 간단한 로컬 대시보드를 제공합니다.

codesstar/loci