Localmind

localmind

localmind는 내 AI에게 "나"를 기억시키는 로컬 기억 계층입니다. 🧠

누구나 AI에게 일을 맡기는 시대 — 그런데 AI는 매번 내가 누구인지, 무엇을 왜 결정했는지 모른 채 새로 시작합니다. localmind를 붙이면 어떤 AI 앱(Claude Code·Claude Desktop·Cursor…)에서든 대화의 부산물로 결정·지식·맥락이 내 .md 노트로 저장되고, 다음 세션의 AI가 그 기억을 가지고 시작합니다. 노트는 전부 내 컴퓨터의 파일이고, git으로 백업·동기화됩니다.

처음이라 용어가 낯설다면 → 👉 5분 비유로 이해하기 부터 보세요.

무엇을 해주나요?

• 📝 기억해 둡니다 — 대화 중 "이거 기록해둬" 하면 AI가 노트로 저장합니다(capture_note). 결정은 선택·이유·전제 3층으로 남깁니다 — 왜 그렇게 결정했는지(why)가 가장 값진 기록입니다.
• 🔍 의미로 찾아줍니다 — "그거 뭐였지?" 하면 내 노트를 의미 기반으로 검색합니다(search_notes).
• 🧭 가지고 시작하게 합니다 — 새 세션의 AI가 작업 주제로 브리핑을 받아, 과거 결정을 이미 알고 시작합니다(brief). "이 프로젝트 뭐 하고 있었지?"를 물을 필요가 없어집니다.
• ⏳ 낡으면 알려줍니다 — 결정이 딛고 선 전제가 오래되면, 그 주제를 다시 만지는 순간 한 줄로 재검증을 권합니다(비차단 — 흐름을 막지 않습니다).
• 🖥️ 기기를 넘어 다닙니다 — 노트는 git 백업/복구로 어느 기기에서든 같은 기억(whoami로 확인).
• 🔒 전부 로컬 — 데이터는 내 컴퓨터에만. 중앙 서버·공유 계정·클라우드 저장 없음.

누구를 위한 건가요?

AI에게 일을 맡기는 사람 모두 — 개발자가 아니어도 됩니다. 이 도구를 실제로 조작하는 것은 사람이 아니라 AI입니다: 사람은 평범한 대화로 맡기기만 하면("기록해둬 / 찾아줘"), AI가 기록하고·찾아보고·브리핑 받으며 내 맥락 위에서 일을 더 잘하게 됩니다. 그렇게 내 지식·결정이 내 컴퓨터에 차곡차곡 쌓이는 나만의 두뇌가 생깁니다.

시작하기

make setup 명령 하나가 준비물 점검·설치·연결을 한국어로 한 단계씩 안내해 줍니다. 막히면 FAQ를 보세요.

준비물: Node.js ≥ 20 · 임베딩 엔진 Ollama (맥: brew install ollama, 컨테이너 대안: docker compose up -d).

git clone https://github.com/shaul1991/localmind && cd localmind
make setup      # 👈 이거 하나 — 준비물·진단·설치·연결을 단계별 안내

임베딩 설정(.env — make setup이 안내):

EMBEDDINGS_URL=http://localhost:11434/v1   # Ollama 직결
EMBEDDINGS_MODEL=bge-m3
EMBEDDINGS_KEY=dummy
NOTES_DIR=~/my-notes                        # 내 .md 노트 폴더(쉼표로 여러 개)

🖥️ 터미널이 처음이라 막막하다면 — clone 후 make guide를 실행하면 브라우저에 시각적 설치 가이드가 열립니다. 배지로 준비물 상태를 보고, 단계별 명령을 [복사]해 붙여넣기만 하면 돼요.

설치가 끝나면 → 👉 첫 사용 튜토리얼 (5분)

MCP로 연동할 수 있는 앱과 설정법

• 내 .md 노트 폴더를 두뇌로 삼으려면 명령 뒤에 NOTES_DIR=/내/노트/폴더(쉼표로 여러 개).
• 적용 전 미리보기 DRY_RUN=1 make mcp-desktop · 도구 4종·환경변수 상세 → MCP로 붙이기.
• 기본은 기기마다 로컬(stdio). 원격(http) 옵션도 있어요 → 홈서버 가이드.

📚 더 알아보기

처음이라면 (비개발자 우선)

• 🎓 첫 사용 튜토리얼(5분) — MCP 연결 → 첫 노트 적재 → 찾아보기
• 🧩 비유로 이해하기 — 5분에 큰 그림
• ❓ 자주 묻는 질문(FAQ) — 설치·연동·백업·성능
• 📖 사용법 — 매일 "기록해둬 / 찾아줘"

더 파고들기 (개발자)

• 🛠️ 레퍼런스 — 동작 원리·색인·환경변수
• 🔌 MCP로 붙이기 — Cursor/Claude Desktop/Cline 연동 + 도구 4종
• 💾 백업 · 복구 — 내 노트를 git repo로, 새 기기 한 줄 복구
• 🏠 홈서버(옵션) — 원격 MCP로 여러 기기에서 한 두뇌 쓰기
• 📐 Product Vision — 이 프로젝트가 지향하는 것("살아있는 why 저장소")
• 🩺 문제 해결 — 잘 안 될 때 증상별 해결

🧰 SDD 워크플로 등 AI 작업 방법론은 이 저장소에 없습니다 — localmind는 기억 계층(코어)만 담당합니다(2026-07 great-reduction — rebuild-plan 참고). 방법론은 애드온으로 갈라져 나가, AI 런타임(Claude Code 등)에 필요한 것만 골라 설치하는 형태가 됐습니다 — localmind-core(세션 시작 브리핑·결정 3층 캡처), sdd-5docs(goal→spec→ plan→tasks→review 문서 체계), goal-impl(문서에서 구현으로). 모든 애드온의 기준은 두 가지 — localmind와 연결될 것, 그리고 형식으로 모델을 제약하지 말 것("무엇이 남아야 하는가"만 정하고 "어떻게"는 모델에 맡깁니다). 현재 별도 비공개 저장소에서 다듬는 중이며, localmind 없이도 이 저장소만으로 기억 계층은 온전히 동작합니다.

🔒 안전한가요? (개인 전용)

이 도구는 내 PC에서 나 혼자 쓰는 용도입니다. 노트·색인·검색 전부 로컬 파일이고, 외부로 나가는 것은 임베딩 호출(기본: 같은 컴퓨터의 Ollama)뿐입니다. 원격(http) 모드를 켤 때만 토큰 인증이 활성화됩니다.

라이선스

MIT — "있는 그대로(AS IS)" 무보증.