---
title: "Consuela — 디펜던시 그래프 기반으로 데드코드 제거하고 파일 분리까지 해주는 코드베이스 청소 도구"
published: 2026-02-01T22:52:58.000Z
canonical: https://jeff.news/article/287
---
# Consuela — 디펜던시 그래프 기반으로 데드코드 제거하고 파일 분리까지 해주는 코드베이스 청소 도구

TypeScript/JavaScript 코드베이스의 전체 디펜던시 그래프를 구축한 뒤, 데드코드 제거·대형 파일 AI 분할·폴더 구조 재배치를 자동으로 수행하는 CLI 도구. ESLint/Knip과 달리 그래프 기반 분석에 AI 리팩토링까지 결합한 것이 차별점.

[Show HN](https://github.com/TeoSlayer/consuela) | HN

- TypeScript/JavaScript 프로젝트의 코드 정리를 자동화하는 CLI 도구가 Show HN에 올라옴. "No no no... I clean"이라는 Family Guy 레퍼런스를 컨셉으로 가져감
- 핵심 차별점은 **코드베이스 전체의 디펜던시 그래프를 먼저 구축**한다는 점임. 모든 export, import, 호출 지점, 심볼 간 관계, 순환 의존성까지 완전한 그래프를 만든 뒤 이를 기반으로 분석과 수정을 수행함
- 주요 기능 세 가지: 데드코드(미사용 export, 빈 파일) 제거, 대형 파일을 AI로 모듈 분리, 폴더 구조 AI 재배치
- `consuela fix`가 메인 명령어로, 문제를 고친 뒤 빌드가 여전히 작동하는지까지 자동 검증함. 첫 실행 시 `.consuela/` 폴더에 분석 캐시와 gold-standard 스냅샷을 생성해 AI 변경이 기존 구조를 망가뜨리지 않는지 확인함
- `consuela diagnose`로 0~100점 건강도 점수를 받을 수 있고, `consuela trace [symbol]`로 특정 함수/타입의 사용처를 라인 번호까지 추적 가능함. `consuela impact [file]`은 특정 파일 변경 시 영향받는 파일을 직접/간접 의존성 포함해서 보여줌
- ESLint나 Knip 같은 기존 도구와의 차이점: ESLint는 파일 단위 린팅, Knip은 미사용 의존성 탐지에 초점이 맞춰져 있는 반면, Consuela는 그래프 분석 + AI 리팩토링(파일 분할, 폴더 재구성)까지 한 단계 더 나아감
- AI 기능은 Google Gemini(gemini-3-flash-preview)를 사용하며 무료 티어로 신용카드 없이 이용 가능함. API 키는 프로젝트가 아닌 사용자 머신에 전역 저장됨
- CI 연동도 지원해서 `--fail` 플래그로 이슈 발견 시 exit code 1을 반환하게 할 수 있음. GitHub Actions 예시도 제공됨
- 라이선스는 AGPL-3.0으로, SaaS에 사용 시 전체 애플리케이션을 오픈소스해야 하는 조건이 있음. 상용 라이선스는 별도 문의 필요
- Python은 실험적 지원 단계이며, 추가 언어 지원이 예정되어 있음

## 핵심 포인트

- 코드베이스 전체의 export/import/호출 관계를 디펜던시 그래프로 구축한 뒤 분석 수행
- 데드코드 제거, 대형 파일 AI 분할, 폴더 구조 AI 재배치 세 가지 핵심 기능
- fix 명령 실행 후 빌드 검증까지 자동화하며 gold-standard 스냅샷으로 변경 안전성 확인
- AI 기능은 Google Gemini 무료 티어 사용, AGPL-3.0 라이선스

## 인사이트

ESLint는 파일 단위 린팅, Knip은 미사용 패키지 탐지에 집중하는 반면, Consuela는 프로젝트 전체 그래프를 기반으로 구조적 리팩토링까지 시도한다는 점에서 레이어가 다름. 다만 AI가 파일을 분할하고 이동시키는 것이 실제 대규모 프로젝트에서 빌드를 안정적으로 유지할 수 있는지는 실사용 검증이 필요함.