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)" ๋ฌด๋ณด์ฆ.