모두가 바라보는 서버 하나
단일 바이너리에 SQLite 파일 하나, markdown 폴더 하나입니다. 사이드카도 벡터 데이터베이스도 없고, 동기화를 맞춰야 할 것도 없습니다.
한 세션이 배운 것을 모든 에이전트가 찾습니다
프로젝트에 작성된 페이지는 서버의 모든 사람이 읽을 수 있습니다. 지난주에 팀원의 Claude Code 세션이 겪은 주의점(gotcha)을 다른 사람의 Codex 세션이 찾아냅니다.
다음 쿼리부터 보입니다
팀원이 남긴 노트는 누구든 다음 검색이나 다음 세션 브리핑에서 보게 됩니다. 이미 실행 중인 세션을 방해하지는 않습니다.
에이전트는 무엇을 섞어 써도 됩니다
각자 좋아하는 에이전트를 그대로 씁니다. 모든 메모리 호출은 세션의 디렉터리로 프로젝트를 판별하므로, 동시에 돌아가는 세션끼리 섞이지 않습니다.
새로 온 개발자의 첫날
키를 받고, 에이전트를 서버에 연결하고, 그동안 무슨 일이 있었는지 프로젝트에 물어봅니다.
프로젝트에 직접 묻습니다
"그동안 있었던 일 알려 줘"라고 하면 최근 작업의 다이제스트가 나옵니다. "재시도 로직에 대해 논의한 적 있어?"라고 하면 결정 페이지와 그 근거가 된 세션들이 나옵니다.
위키는 살아 있는 지식 베이스입니다
개념, 결정, 주의점이 작업이 진행되는 대로 markdown으로, git 히스토리와 함께 기록됩니다. 누군가 잊지 않고 업데이트해야 할 필요가 없습니다.
직접 쓴 문서를 보완합니다
페이지는 세션에서 만들어지며 에이전트가 찾아 쓰기 좋은 형태입니다. 손으로 쓴 README와 아키텍처 문서는 그대로 두고, 위키에는 이유와 막다른 길을 맡기세요.
다이제스트는 서버에 LLM 제공자가 있으면 문장으로, 없으면 구조화된 데이터로 나옵니다. --enable-web을 켜면 같은 위키를 읽기 전용 웹 UI로 둘러볼 수 있습니다.
지식은 공유하고, 바통에는 주인이 있습니다
페이지는 프로젝트의 것입니다. 인수인계는 그것을 남긴 사람의 것입니다.
- 대기 중인 인수인계(핸드오프)는 여러분의 다음 세션으로 갑니다. 같은 저장소에서 에이전트를 시작한 팀원이 그것을 받거나 소비하는 일은 없습니다.
- 작업을 이어받을 누구에게든 바통을 공개하고 싶다면
shared: true를 넘기세요. - 두 사람이 같은 페이지를 수정하면 버전 체인이 만들어집니다. 나중에 쓴 쪽이 최신이 되고, 먼저 쓴 쪽도 계속 조회할 수 있습니다. 병합은 없고 사라지는 것도 없습니다.
- 선택 사항인 개인 슬롯에는 "지금 내가 하고 있는 일"이 담기며 팀 브리핑에는 나오지 않습니다. 기본값은 꺼짐입니다.
# 기본은 개인용: 여러분의 다음 세션만 받습니다
"다음 세션을 위해 맥락을 저장해 줘."
# 의도적으로 공개하기: memory_handoff_begin with shared: true
"내일 이 작업을 이어받는 사람이 받을 수 있게 공유 인수인계를 저장해 줘."
에이전트끼리 프로젝트를 넘어 메시지를 보낼 수 있습니다
프런트엔드 저장소의 에이전트에게 API 저장소의 엔드포인트가 필요합니다. 에이전트는 그 자체로 완결된 요청을 해당 프로젝트의 인박스로 보내고, 그쪽의 다음 세션이 이를 꺼냅니다. 메시지는 한 번만 수령되고, 수신 프로젝트는 이미 존재해야 하며, 인박스에는 대기 메시지가 최대 256개까지 쌓입니다. 도구는 GitHub의 에이전트 메시징 가이드에 나와 있습니다.
계정, 키, 감사 기능까지. 유료 티어는 없습니다
팀 기능은 나머지 전부와 같은 MIT 바이너리에 들어 있습니다.
사람마다 이름 있는 계정
명령 하나로 사람을 추가합니다. 누군가를 비활성화하면 접근은 끊기고 그 사람의 페이지는 남습니다.
컴퓨터별 API 키
한 사람이 노트북이나 에이전트마다 하나씩, 라벨을 붙인 키를 여러 개 가질 수 있습니다. 키를 교체하면 이전 키는 즉시 거부됩니다.
모든 쓰기에 작성자 표시
페이지마다 작성자가 기록되고, 웹 UI에서 누가 수정했는지 볼 수 있습니다. 작성자 정보가 읽기 권한을 제한하는 일은 없습니다.
모든 변경을 담는 감사 로그
쓰기는 작성자의 id와 함께 기록됩니다. admission 웹훅은 행위자를 확인하고 작업을 거부할 수 있습니다.
감사 로그를 조회하는 화면이나 명령은 아직 문서화된 것이 없으므로, SQLite 파일의 audit_log 테이블을 직접 쿼리한다고 생각하세요. 역할, 비밀번호 로그인, 키 교체는 GitHub의 사용자 가이드에서 다룹니다.
서버 한 대가 초당 약 700건의 쓰기를 처리하며, 이는 활성 에이전트 수백 개를 감당하는 수준입니다. 측정 방법 보기.
팀 설정하기
설치 페이지에서 순서대로 안내합니다. 서버 한 대를 띄우고, 사람마다 키를 발급하고, 각자의 에이전트가 그 서버를 바라보게 합니다.
자주 묻는 질문
여러 개발자가 ai-memory 서버 하나를 함께 쓸 수 있나요?
네. 서버 하나가 위키를 보관하고 모두가 자기 에이전트를 그 서버에 연결합니다. 페이지는 서버의 모든 사람이 공유합니다. 인수인계는 shared: true로 공개하지 않는 한 만든 사람에게만 남습니다.
팀으로 쓰려면 유료 티어가 필요한가요?
아니요. 사람별 계정, API 키, 작성자 표시, 감사 로그는 오픈 소스 바이너리에 포함되어 있습니다.
프로젝트나 페이지를 일부 사용자에게만 제한할 수 있나요?
아니요. 계정은 테넌트 경계가 아닙니다. 인증된 사용자는 누구나 그 서버의 모든 프로젝트, 모든 페이지를 볼 수 있습니다. 팀마다 서버를 하나씩 운영하세요.
서버 하나로 개발자 몇 명까지 감당할 수 있나요?
측정된 쓰기 상한은 빠른 로컬 디스크 기준 초당 약 700회이며, 프로젝트는 이를 동시에 활동하는 에이전트 수백 개 수준으로 해석합니다. 이 수치는 저장소 계층을 측정한 것이고, 네트워크 디스크에서는 더 느립니다.