Ziplex

프로젝트가 어느 정도 커지면 AI한테 매번 같은 걸 다시 설명하게 되더라고요. 파일 구조가 어떻게 생겼는지, 이 함수를 어디서 쓰고 있는지, 이 모듈을 건드리면 어디까지 영향이 가는지. 새 세션을 열 때마다 이걸 반복하다 보니, 정작 하려던 작업보다 "설명"에 시간을 더 쓰는 날도 있었습니다. 그래서 프로젝트를 한 번 읽어서 AI가 바로 이해할 수 있는 요약 파일 하나로 만들어주는 걸 만들어봤습니다. Ziplex라는 이름을 붙였습니다. 폴더 골라주고 버튼 몇 번이면 끝나는 GUI가 메인입니다. Tree-sitter로 코드 구조를 뽑고 함수 본문은 압축해서 LLM이 파일마다 한 줄 요약을 씁니다(AI 요약은 API 키가 있어야 동작하고, 키 없이 구조 정보만으로 먼저 체험도 가능합니다). 특히 신경 쓴 부분은 파일 간 의존관계입니다 — 어떤 파일이 어떤 파일을 쓰고 있는지, 하나를 고치면 어디까지 영향이 번지는지를 그래프로 같이 뽑아냅니다. 요약과 관계는 저장 전에 GUI 화면에서 검토하고 고칠 수 있습니다. 원본 대비 토큰이 크게(자체 측정 기준 90%대 후반) 줄어들면서도 파일 간 관계는 살아있어서, "이거 고치려면 뭘 같이 봐야 하지"를 AI가 먼저 알고 시작할 수 있습니다. 터미널을 선호하시면 CLI나 MCP 서버 연결도 지원합니다. `pip install ziplex` 하고 `ziplex-gui`만 치시면 바로 열립니다. 첫 오픈소스 프로젝트라 부족한 점이 많을 것 같습니다. 써보시고 불편한 점이나 아쉬운 점 있으시면 편하게 알려주시면 정말 감사하겠습니다.