AI 가이드

에이전트 기억 문서만 커서에 넣는 4단계

읽는 데 12분스텝 4개섹션 8개2026-09-30 공개

에이전트 기억 제품은 서버와 키가 먼저 나옵니다. 이 자료는 2026년 9월 30일 주간 트렌드의 vectorize-io/hindsight에서, hindsight-docs 스킬만 커서에 넣어 용어를 읽게 하는 네 단계를 담았습니다. Docker와 OpenAI 키는 쓰지 않습니다.

복사해서 바로 시작하는 프롬프트. 문서 스킬 설치와 한 질문까지 AI에게 맡기기.

복사해서 바로 시작하는 프롬프트

역할: 이 프로젝트의 커서에 Hindsight 문서 스킬만 설치하는 담당
맥락: 개인 사이트입니다. Docker 서버, Cloud, API 키, 기억 은행은 만들지 마세요.
입력: Node·npx는 직접 확인하세요.
작업: ① `npx skills add https://github.com/vectorize-io/hindsight --skill hindsight-docs` 를 실행하세요. `--global` 은 사용자가 원할 때만. ② 설치된 SKILL.md 경로를 보여 주세요. ③ 사용자에게 새 채팅에서 물을 문장 하나를 주세요. 문장은 "Hindsight의 retain·recall·reflect가 각각 무엇을 하는지, 이 사이트 칼럼 발행에 비유해서 설명해 줘. 서버는 켜지 말 것." 입니다. ④ Docker run 예시는 출력하지 마세요.
제약: OPENAI_API_KEY 를 묻거나 환경변수에 넣지 마세요. 컨테이너를 실행하지 마세요.
출력: 설치 경로, 시험 문장
검증: hindsight-docs 의 SKILL.md 가 있어야 합니다. 8888 포트 서버가 떠 있으면 완료가 아닙니다.

Quick Start

공식 저장소: vectorize-io/hindsight
문서: hindsight.vectorize.io
한 줄 정의: 에이전트가 장기 기억으로 배우게 하는 시스템입니다. 이 자료는 문서 스킬만 씁니다.
인기·만든 곳: 2026년 9월 30일 GitHub 트렌드(This week) 기준 스타 42,844개, 한 주 동안 17,365개가 늘었습니다. 만든 곳은 Vectorize입니다.
라이선스: MIT.
필요한 환경: Node.js와 npx, 커서. 서버를 켜려면 Docker와 LLM 키가 따로 필요합니다.
비용: 문서 스킬은 무료입니다. 서버·Cloud는 모델 키나 사용량 요금이 붙습니다.

터미널에서 실행

npx skills add https://github.com/vectorize-io/hindsight --skill hindsight-docs

검증: 2026-09-30 기준 (README "Using a coding agent?", License MIT)

STEP 1. 왜 서버를 안 켜는지 보기: 2분

README Quick Start의 Docker 예는 API 키를 넣습니다. 공직·개인 글이 오가는 맥에서 기억 서버를 먼저 올리는 일은 이 자료의 범위가 아닙니다.

STEP 2. 문서 스킬만 넣기: 3분

터미널에서 실행

npx skills add https://github.com/vectorize-io/hindsight --skill hindsight-docs

클로드 코드와 커서에서 문서 검색용으로 켜집니다.

STEP 3. 용어만 물어보기: 4분

retain은 남기기, recall은 꺼내기, reflect는 정리하기입니다. 칼럼을 쓰고 목록에 올리고 나중에 다시 찾는 일과 겹쳐 이해하면 됩니다. 실제 은행을 만들지는 않습니다.

STEP 4. 나중에 서버를 켤 때: 3분

그때는 공식 설치 가이드를 따릅니다. 로컬 모델(Ollama 등) 옵션이 README에 있습니다. 키가 필요 없는 경로를 고르는 편이 안전합니다.

자주 막히는 곳

hindsight-api pip 설치는 서버입니다. 문서 스킬과 이름이 닮아 헷갈립니다.
Cloud 가입은 이 자료에 없습니다.

솔직히 한계

문서 스킬만으로는 에이전트가 지난 대화를 기억하지 않습니다. 용어를 읽을 뿐입니다.
벤치마크 숫자는 논문·리더보드 쪽입니다. 이 홈페이지의 체감과는 거리가 있습니다.

되돌리기. npx skills remove hindsight-docs 또는 .cursor/skills/ 아래 해당 폴더만 지웁니다.

공식 자료

저장소: vectorize-io/hindsight
문서: hindsight.vectorize.io
논문: arXiv 2512.12818
라이선스: MIT