AI에게 기억을 심는 방법, 서버 없이 파일로
위너독 — 마크다운 메모리와 야간 학습으로 클로드 코드·코덱스가 나를 기억한다
모델을 바꾸지 않고 모델 주변에 파일만 깔아 AI의 기억과 습관을 만들어 준다는 오픈소스 도구가 공개됐다. 이름은 위너독(Wienerdog). 데몬도 서버도 원격 수집도 없이 오로지 파일로만 동작하며, 클로드 코드(Claude Code)와 코덱스 CLI(Codex CLI)를 오가도 같은 기억을 공유한다는 점을 전면에 내세운다.
무슨 일인가 / 배경
코딩 에이전트를 오래 쓴 사람이라면 익숙한 불편이 있다. 세션을 새로 열 때마다 내가 누구고 어떤 규칙으로 일하는지를 다시 설명해야 한다는 점, 그리고 도구를 바꾸면 그동안 쌓인 맥락이 통째로 사라진다는 점이다. 위너독은 이 문제를 모델이 아니라 파일 배치의 문제로 정의한다.
설치하면 네 가지가 깔린다. 사용자에 대한 실제 프로필, 계속 남는 마크다운 메모리, 반복 업무를 위한 스킬, 그리고 대화에서 배우는 야간 '드리밍' 과정이다. 클로드 코드와 코덱스를 함께 쓴다면 하나의 메모리 저장소를 양쪽이 함께 읽고 쓴다. 도구를 갈아탄다고 아무것도 모르는 AI와 처음부터 다시 시작할 필요가 없다는 뜻이다. 프로젝트는 MIT 라이선스로 공개돼 있고, 저장소에는 메모리·스킬·템플릿·문서 디렉터리와 함께 900건 가까운 커밋이 쌓여 있다.
핵심 짚어보기
설계에서 가장 눈에 띄는 선택은 "아무것도 듣고 있지 않고, 아무것도 외부로 보내지 않는다"는 원칙이다. 상주 프로세스가 없으니 포트도 열리지 않고, 제거 명령 한 번이면 자기가 만든 파일을 전부 지운다. 파일뿐이라는 구조는 곧 버전 관리와 백업이 쉽다는 뜻이기도 하다.
설치는 npx wienerdog@latest init 한 줄이다. 다만 실행 전에 무엇이 생기는지 보고 싶다면 --dry-run 옵션을 붙여 계획만 출력하고 파일은 건드리지 않게 할 수 있다. 노드(Node)가 없는 환경을 위해 맥·리눅스용 셸 스크립트와 윈도우용 파워셸 스크립트도 제공되는데, 두 스크립트는 노드와 깃 설치 여부를 확인한 뒤 없으면 설치를 제안하되 항상 먼저 묻고 실행할 명령을 그대로 보여준다. 사용자가 거절하거나 비대화형 환경이면 명령만 출력하고 물러난다. 윈도우도 동등하게 지원한다고 명시돼 있으며, 노드 설치 과정에서 뜨는 관리자 권한 창은 윈도우가 묻는 것이지 이 도구가 요구하는 것이 아니라는 설명까지 붙어 있다.
작은 디테일이지만 이런 설계는 시사하는 바가 있다. 자동화 도구의 신뢰는 기능이 아니라 "미리 보여주고, 묻고, 지울 수 있다"는 세 가지에서 나온다.
1인기업 실전 적용 포인트
- 먼저 프로필 파일부터 만들어라. 도구 도입 여부와 무관하게, 내 사업 정의·고객·금지 표현·문체 규칙을 담은 마크다운 한 장을 만들어 에이전트 지침 파일로 두면 매 세션 반복 설명이 사라진다. 이 저장소의
CLAUDE.md가 정확히 그 역할이다. - 반복 업무 세 개를 스킬로 떼어내라. 매주 하는 일 중 절차가 고정된 것(예: 뉴스 수집 후 초안 작성, 주간 보고서 취합)만 골라 절차 문서로 만들면, 다음부터는 한 줄 호출로 끝난다.
- 메모리 저장소를 깃으로 관리하라. 기억이 파일이라는 말은 곧 이력이 남는다는 뜻이다. 메모리 디렉터리를 저장소에 넣어두면 AI가 잘못 학습한 내용을 되돌리는 일이 커밋 하나로 끝난다.
- 야간 학습 대상에서 민감한 대화를 빼라. 대화 로그를 훑어 기억을 만드는 기능은 편리한 만큼 위험하다. 고객 이름·연락처·계좌가 오간 세션은 학습 경로에서 제외하거나 마스킹한 뒤 넣는 규칙을 처음부터 정해두는 편이 안전하다.
전망 / 주의점
주의할 점도 분명하다. 공개 직후의 신생 프로젝트라 별 개수와 사용자 기반이 아직 작고, 셸 스크립트를 내려받아 바로 실행하는 설치 방식은 편리한 만큼 내용을 한 번 읽어보고 진행하는 편이 좋다. 무엇보다 대화 기록을 자동으로 읽어 요약을 남기는 구조이므로, 개인정보가 오가는 작업에 그대로 붙이는 것은 권하기 어렵다.
그럼에도 방향 자체는 눈여겨볼 만하다. 지난 1년의 경쟁이 더 똑똑한 모델이었다면, 지금 벌어지는 경쟁은 같은 모델을 두고 주변 파일을 얼마나 잘 정리하느냐로 옮겨가고 있다. 도구를 도입하지 않더라도 프로필·메모리·스킬이라는 세 폴더를 손으로 만들어 보는 것만으로 체감 차이는 생긴다.
출처: GitHub (https://github.com/wienerdog-ai/wienerdog/)