AI 코딩 에이전트를 위한 공유적이고 지속적인 메모리 시스템

AI 코딩 에이전트를 위한 공유적이고 지속적인 메모리.

하나의 하네스(harness)가 학습한 모든 것을 다른 하네스들이 세션, 도구, 장치 및 팀원을 거쳐 기억합니다.

Legion Code Inc. × Activeloop 협업.

AI 코딩 에이전트는 잊어버립니다. 세션을 넘어서도 잊고, 도구를 넘어서도 잊습니다. 자정의 Claude Code에서 내린 결정은 다음 날 아침 Cursor에게는 보이지 않습니다. Honeycomb이 이를 해결합니다. 로컬 데몬(daemon)이 모든 턴마다 발생하는 일을 포착하고, 이를 정제하여 요청하는 모든 하네스에 다시 제공합니다. 한 번 학습한 것을 어디서든, 어떤 기기에서든, 어떤 도구에서든, 팀원 누구에게나 기억하게 만드세요.

이는 여러분이 계속해서 두 번 비용을 지불하는 질문들에 답합니다: 우리는 이것에 대해 무엇을 결정했는가? 왜 이렇게 구축되었는가? 지난번에 고장 났을 때 무엇이 이를 수정했는가? 팀원 중 누가 이미 이 문제를 해결했는가?

새로운가요? 하나의 명령어로 대시보드에서 시작할 수 있습니다. 설치(Install)로 이동하세요. ·문서(docs)를 원하시나요? 모든 것이 attheapiary.sh에 있습니다.

|
매일 아침 프로젝트 설명을 새로운 에이전트에게 반복하는 것을 멈추세요. Honeycomb은 여러분의 결정, 컨벤션, 그리고 작동했던 수정 사항들을 기억하고, 다음 세션에 자동으로 이를 주입합니다. 하나의 설치 명령어로, 친근한 대시보드와 함께 SQL이나 복잡한 설정 과정 없이 사용할 수 있습니다. |
하나의 공유된 두뇌가 모든 개발자, 장치, 코딩 도구 전반에 걸쳐 존재합니다. 한 엔지니어가 발견한 기술은 다음 세션에서 팀 전체로 전파됩니다. 테넌시(Tenancy)는 스토리지 계층에서 강제되며, 자격 증명(credentials)은 단일 루프백 경계 뒤에 존재합니다. 모든 것이 버전 관리되고 감사 가능합니다. |

벡터 데이터베이스(vector database)는 텍스트를 저장하고 유사도에 따라 돌려줄 수 있습니다. Honeycomb은 그렇게 할 뿐만 아니라, 그 이상을 합니다. Activeloop Deeplake 위에 Legion Code가 에이전트들이 실제로 신뢰하는 두뇌로 원시적인 기억을 변환하는 메모리 시스템을 구축합니다.

🧠 3단계 메모리(Three-tier memory). 모든 메모리는 동시에 세 가지 해상도로 존재합니다 (한 줄 키(key) → 요약(summary) → 전체 원문(raw) 세션). 에이전트는 키를 빠르게 훑어보고, 필요할 때만 상세 내용으로 확대합니다.(Legion Code)🎯 세션 프라이밍(Session priming). 세션 시작 시 가장 관련성 높은 키의 작고 제한된 인덱스(~300-800 토큰)가 한 번 푸시됩니다. 에이전트는 필요할 때 더 깊게 가져옵니다. 턴마다 주입되지 않으며, '중간에 손실되는(lost in the middle)' 현상이 없습니다.(Legion Code)🍯 스킬화 및 전파(Skillify & propagation). 데몬은 실제 세션에서 재사용 가능한 스킬을 채굴하고, 품질을 위해 게이팅하며, 팀의 최신 스킬을 모든 에이전트에게 세션 시작 시 자동으로 가져옵니다. 한 번 스킬을 작성하면 모두가 사용할 수 있습니다.(Legion Code)🌼 꽃가루 매개 루프(The pollinating loop). 주기적인 유지보수 패스가 축적된 메모리와 엔티티 그래프를 추론하여 중복을 병합하고, 불필요한 정보를 가지치기하며, 오래된 사실을 대체합니다. 따라서 메모리는 시간이 지남에 따라 노이즈가 많아지기보다 더 선명해집니다.(Legion Code)🕸️ 지식 그래프(Knowledge graph). 사용자의 메모를 중심으로 하는 엔티티 중심적이며, 버전 관리되고, 출처 추적이 가능한 인덱스입니다. 새로운 사실은 오래된 사실을 대체하며, 모든 주장은 그것을 생성한 세션으로 역추적됩니다.(Legion Code)🔀 하이브리드 검색(Hybrid recall). 어휘 기반(BM25) 및 의미론적(768차원 벡터) 검색이 상호 순위 융합(Reciprocal Rank Fusion)으로 융합되며, 측정된 재현율@5 ≈ 0.72-0.78을 보입니다.(Deeplake 기반)🗺️ 코드베이스 그래프(Codebase graph). 파일, 함수 및 이들의 호출/임포트/확장 관계를 포함하는 다중 언어 AST 그래프(TypeScript, JS, Python, Go, Rust, Java, Ruby, C/C++)로, 영향도와 근접성을 쿼리할 수 있습니다.(Legion Code)

Node가 없나요? npm이 없나요? 문제없습니다. 설치 프로그램이 모든 것을 감지하고 설정한 다음, 브라우저에 대시보드를 열어줍니다. 터미널은 단지 진행 로그일 뿐이며, 제품은 사용자가 가장 먼저 만지는 것입니다.

# macOS / Linux
curl -fsSL https://get.theapiary.sh | sh

# Windows (PowerShell)
irm https://get.theapiary.sh/install.ps1 | iex

이 한 줄로 현재 Node/npm을 설치하거나 누락된 경우 설치하고, @legioncodeinc/honeycomb을 전역으로 가져오며, 데몬을 다음 주소에 띄웁니다:

127.0.0.1:3850

), 대시보드(Hive 포털 127.0.0.1:3853)를 열고 모든 것이 정상적으로 작동하는지 확인하는 작은 감시견인 Doctor를 설정합니다 (비활성화하려면 --no-doctor 사용). 그런 다음:- 대시보드는 사전 인증(pre-auth) 설정 상태로 로드됩니다. 토큰은 절대 셸에 노출되지 않습니다. - **"첫 사용 설정(First time setup)."**을 클릭합니다. Honeycomb이 귀하를 대신하여 Deeplake 장치 흐름 로그인*을 실행하고, 코드를 페이지에 바로 표시하며, 인증 탭을 엽니다. - 완료되었습니다. 동일하게 실행되는 데몬이 Deeplake 기반 표면들을 밝히고, 캡처 및 검색 기능이 활성화됩니다.

이미 실행 중인 경우

Hivemind? 대시보드는 이를 감지하고 두 가지를 동시에 실행하는 것은 지원되지 않는다고 설명하며, "Honeycomb으로 진행(Proceed with Honeycomb)"을 통해 깔끔하게 마이그레이션합니다. 파이프하기 전에 검사하는 것을 선호하십니까? 스크립트와 게시된 SHA256SUMS는 get.theapiary.sh에서 제공됩니다.

소스에서 빌드하는 것을 선호합니까?

git clone https://github.com/legioncodeinc/honeycomb.git
cd honeycomb
npm install
...

setup 명령어는 감지된 모든 코딩 어시스턴트의 와이어를 연결하고 루프백 데몬을 시작합니다. 모든 스토리지 명령은 데몬이 다운되어 있을 경우 자동으로 데몬을 시작합니다. Activeloop Deeplake 자격 증명이 필요하며, 위에서 설명한 장치 흐름(device flow)은 이를 공유된 ~/.deeplake/credentials.json에 작성합니다.

스토리지 백엔드를 자체 호스팅하십니까? 호스팅되는 Deeplake 대신 Activeloop의 오픈 소스 pg_deeplake Postgres 확장을 사용하여 Honeycomb을 실행할 수 있으며, honeycomb login --endpoint postgres://... (직접) 또는 --endpoint https://... (HTTP 게이트웨이)를 사용하여 Honeycomb을 연결할 수 있습니다. Activeloop 계정이 필요하지 않습니다. 설정 및 백엔드 계약에 대해서는 자체 호스팅 가이드를 참조하십시오.

대시보드는 전체 Apiary 스택의 단일 UI인 **Hive 포털(http://127.0.0.1:3853)**이며, 설치 프로그램이 가장 먼저 여는 화면입니다. Honeycomb의 이전 인-데몬 대시보드는 폐지되었으며, 데몬은 :3850에서 실행됩니다.

데이터를 제공하고, 포털은 이미지를 제공합니다. Honeycomb이 아는 모든 것이 거기에 표시됩니다: 상단의 핵심 성과 지표(KPIs) (메모리, 턴 수, 예상 절감액, 팀 기술), 직접 질의할 수 있는 메모리 검색, 코드베이스 그래프, 캡처된 모든 턴, 스킬 동기화 상태 및 설정이 데몬의 API를 통해 서버 측에서 로드됩니다. 또한 첫 로그인용 가이드형 설정 표면 역할도 겸합니다. 하나의 통합된 honeycomb 바이너리가 모든 것을 구동합니다. 전체 목록은 honeycomb --help로 실행하세요. 다음은 핵심 동사들입니다:

honeycomb install # 신규 장치에 대한 일회성 설치
honeycomb setup # 코딩 어시스턴트를 감지하고 후크 연결
honeycomb status # 데몬 + 환경 상태 한눈에 확인
...

몇 가지 라이프사이클 참고 사항:

• 전체 스위트 명령어 계약은 공유됩니다. 규범적 매트릭스와 의미론은 @legioncodeinc/cli-kit에 있습니다. 이 섹션은 Honeycomb 전용 동작 및 호환성 명령만 문서화합니다.
• 자동화는 구조화되어 있습니다. 모든 기본 운영 동사는 --json을 허용합니다. 잘못된 사용 시 종료 코드 2, 런타임 실패 시 종료 코드 1, 성공/멱등 요청 시 종료 코드 0이 발생합니다. 일반 사용자 출력을 위해 --no-color 또는 NO_COLOR=1을 사용하세요.
• 로그는 격리됩니다. honeycomb logs는 Honeycomb의 구성된 서비스 로그만 읽을 수 있습니다. 이는 --lines <n>, --no-follow, 그리고 --since <기간-또는-타임스탬프>를 지원하며, 출력에서 인식된 자격 증명을 마스킹합니다.
• 로그인은 소유자를 파악합니다. Hive가 함께 설치될 때, honeycomb install은 자체 로그인 창을 열지 않습니다. Hive의 온보딩이 유일한 로그인 표면이며, 데몬은 공유되는 ~/.deeplake/credentials.json에 로그인이 쓰여질 때까지 /health에서 저하된 상태로 대기하다가 스스로 복구됩니다. 재시작할 필요가 없습니다. 단독(Hive 없음)의 경우, 자격 증명이 없는 신규 설치는 자동으로 장치 흐름 로그인(device-flow sign-in)을 열고, 헤드리스 세션에서는 브라우저 대신 URL과 코드를 출력합니다. honeycomb login

두 모드 모두에서 원하는 때에 동일하게 작동합니다. - Honeycomb의 요소들만 제거합니다: 어시스턴트 훅(assistant hooks), OS 서비스 유닛(OS service unit) (현재 및 레거시 레이블), Doctor의 레지스트리 내 Honeycomb 항목, 그리고 uninstall

은 수술적입니다. ~/.apiary/honeycomb

공유 자격 증명과 다른 모든 제품은 살아남습니다. 아무것도 설치되지 않은 상태에서 실행해도 안전한 무작위 작업(no-op)입니다. 전체 시스템을 초기화하려면 doctor purge를 사용하거나 get.theapiary.sh에서 원클릭 제거를 사용하세요.

# 결정을 한 번 캡처합니다…
honeycomb remember "우리는 prd-022 브랜치에서 배포하며, 절대 main에서는 하지 않는다"
# …어디서든 상기합니다: 동일한 데몬, 동일한 Deeplake, 모든 하네스
...

Claude Code에서 작성하고; 다른 노트북의 Cursor에서 내일 상기하세요. 그것이 핵심입니다.

Honeycomb은 장기간 유지되는 로컬 **데몬(daemon)**과 얇은 클라이언트들로 구성되어 있습니다. 이 데몬만이 스토리지와 통신하는 유일한 프로세스입니다. 모든 하네스, CLI, MCP 서버, 그리고 SDK는 루프백 HTTP를 통해 여기에 접근합니다. 하나의 경계 뒤에 공유된 메모리; 정확히 한 곳에 있는 귀하의 Deeplake 자격 증명입니다.

flowchart TB
CC["Claude Code"] --> TC
CU["Cursor"] --> TC
...

모든 턴에서 캡처합니다. 하네스별 훅(Per-harness hooks)이 각 턴을 데몬으로 스트리밍하고, 데몬은 이를 증류하여 영구 저장합니다: 항상 작동하며 저렴하고 소프트 실패를 하므로 캡처 오류가 에이전트의 턴을 중단시키지 않습니다.데몬을 통해 상기합니다. 모든 하네스가 관련 메모리를 요청하면; 데몬이 쿼리를 실행하고 결과를 귀하의 조직 및 작업 공간에 이미 범위 지정된 상태로 반환합니다. 클라이언트는 스토리지 핸들이나 SQL 코드를 절대 볼 수 없습니다.구조적으로 공유됩니다. 모든 클라이언트가 동일한 데몬과 동일한 데이터셋에 접근하기 때문에, 한 하네스에서 작성된 메모리는 다른 모든 하네스에서도 상기할 수 있습니다.

이것이 Legion Code가 Deeplake 위에 추가하는 핵심입니다. 동일한 메모리가 동시에 세 가지 수준의 상세도로 존재하며, 에이전트는 얼마나 확대할지 선택합니다:

해결 과정은 퍼지 검색(fuzzy search)이 아닌 결정론적(deterministic) SQL 조인입니다. key → summary → raw는 세 개의 Deeplake 테이블을 따라 내려가는 포인터 워크(pointer walk)입니다. 마이닝("내가 몰라서 이름을 붙이지 못했던 것 찾기")은 하이브리드 벡터 + 렉시컬 검색이 작동하는 지점입니다. 빠르게 훑어볼 때는 저렴하고, 확대해서 볼 때는 정밀합니다.

대부분의 에이전트 메모리 도구는 벡터 전용 스토어에 붙어(bolt onto) 있어, 모든 접근 패턴을 유사도 엔진(similarity engine)을 통해 거치도록 강제합니다. Honeycomb의 줌 모델은 정확한 조인(exact joins)과 의미론적 검색(semantic search) 둘 다가 필요하며, AI를 위한 데이터베이스인 Deeplake는 이 두 가지 모두를 네이티브하게 제공합니다:

하나의 엔진에서 SQL과 벡터 검색을 함께 사용합니다. 저렴한 훑어보기와 결정론적인 확대 기능은 SQL로 실행되며; 의미론적 마이닝은 벡터 검색으로 실행됩니다. 단일 스토어가 둘 다를 처리합니다. 두 번째 데이터베이스가 필요 없고, 동기화 문제가 없습니다.

버전 관리 및 추가 전용(Versioned & append-only). 쓰기는 제자리에서 변경하는 대신 버전을 증가시키므로, 메모리의 전체 기록이 디스크에 유지됩니다. 초과(Supersession) 표시는 오래된 사실을 손실하지 않고 '오래되었다'고 표시하여, 이는 꽃가루 매개 루프(pollinating loop)를 안전하고 감사 가능하게 만드는 요소입니다.

하이브리드 렉시컬 + 의미론적 검색. BM25와 768-dim의 nomic-embed-text-v1.5 코사인 팔(cosine arms)을 역쌍대 순위 결합(Reciprocal Rank Fusion)으로 융합합니다. 임베딩을 비활성화해도 재현율(recall)은 오류가 아닌 렉시컬 검색으로 조용히 되돌아가며, 품질 급락 현상이 없습니다.

확장성 및 BYOC 지원. 한 개발자의 노트북에 서비스를 제공하는 것과 동일한 기반 구조가 원한다면 조직 전체의 기록을 사용자의 클라우드 버킷에서 서비스할 수 있습니다.

Honeycomb은 두 가지 축 위에 서 있습니다:

Deeplake는 메모리가 저장되고 쿼리 가능한 영속적인 공간을 제공하며, Activeloop의 오픈 소스 에이전트 메모리 프로젝트인 Hivemind는 Legion Code가 Honeycomb의 다단계 시스템으로 확장된 기반입니다.

Honeycomb은 프로덕션 환경에서 3가지 하네스를 지원합니다 (Claude Code, Codex, Cursor). Hermes, pi, 그리고 OpenClaw는 개발 진행 중입니다.

honeycomb setup은 설치된 것을 감지하고 각각을 독립적으로 연결하며, honeycomb uninstall는 Honeycomb가 변경한 내용만 되돌립니다. Cursor에서 마이닝된 스킬은 다음 세션에서 Claude Code에 자동으로 가져와 준비됩니다.

CLI 외에도 동일한 데몬과 공유 메모리에 접근하는 세 가지 방법이 더 있습니다:

대시보드(Dashboard). 위에서 다룬 대로 http://127.0.0.1:3853의 Hive 포털을 이용할 수 있습니다. 전체 스택을 위한 하나의 진입점이며, Honeycomb의 데이터는 이 경로를 통해 활성화됩니다.MCP 서버(MCP server). Honeycomb의 읽기/해결 및 검색/마이닝 도구를 모든 MCP 지원 호스트에 노출하는 모델 컨텍스트 프로토콜(Model Context Protocol) 서버입니다 ( mcp/bundle 에 번들링됨).TypeScript SDK. 프레임워크 서브 경로 항목(react, /vercel, /openai)을 가진 @legioncodeinc/honeycomb 클라이언트입니다. 핵심 진입점은 fetch 전용이며 브라우저에서 안전합니다. react와 ai는 선택적 동료(optional peers)입니다.

Honeycomb은 **프로덕션 준비 완료 상태 (v0.4.x)**이며 실제 시나리오에서 완벽하게 테스트되었습니다. 우리는 실제로 작동하는 것을 문서화하고 옵트인(opt-in) 기능을 표시합니다.

오늘의 프로덕션 기능

• 캡처-리콜(Capture-to-recall): Deeplake를 대상으로 검증된 엔드투엔드 및 라이브 테스트 완료 (npm run smoke:golden-path)