최근 AI 코딩 에이전트(AI coding agent) 활용이 보편화되면서 개발자들의 생산성은 크게 향상되었지만, 새로운 골칫거리도 생겨났습니다. 코덱스(Codex), 클로드 코드(Claude Code) 같은 AI 에이전트들이 병렬로 작업을 수행하면서 수많은 임시 작업 공간(worktree)을 생성하고, 각 작업 공간마다 프로젝트 의존성 파일(node_modules, .venv 등)과 빌드 산출물(.next, target 등)을 복제하여 디스크 공간을 빠르게 잠식하는 문제입니다. 어느 날 갑자기 디스크가 가득 차 확인해보면, AI 에이전트가 남긴 수십 기가바이트의 불필요한 파일들이 쌓여 있는 것을 발견하게 됩니다.
이러한 문제를 해결하기 위해 'agent-gc'라는 새로운 터미널 사용자 인터페이스(TUI) 도구가 등장했습니다. 이 도구는 AI 에이전트의 작업 흐름에 맞춰 특별히 설계되었으며, 코덱스, 클로드 코드, 오픈코드(OpenCode), 커서(Cursor), 제미니(Gemini), 에이더(Aider), 오르카(Orca) 등 주요 AI 에이전트들이 사용하는 경로와 일반 개발 프로젝트 경로를 모두 스캔합니다. 스캔 후에는 의존성 폴더, 빌드 산출물, 언어별 캐시 등을 찾아 크기, 마지막 수정 시각, 프로젝트 정보, Git 상태와 함께 사용자에게 보여줍니다. 특히, 오탐(false positive)을 줄이기 위해 특정 마커(예: Cargo.toml이 있을 때만 target 폴더를 인식)를 활용하고, .env나 .db 같은 중요한 파일이 포함된 폴더는 '위험(DANGER)'으로 분류하여 사용자가 실수로 삭제하지 못하도록 잠금 처리하는 안전장치도 갖추고 있습니다.
'agent-gc'는 Rust와 ratatui로 개발된 단일 바이너리 형태로 제공되며, macOS, Linux, Windows 등 다양한 운영체제를 지원합니다. 사용자는 'npx agent-gc' 명령어를 실행하여 TUI를 통해 직관적으로 불필요한 파일을 확인하고 선택적으로 삭제할 수 있습니다. 또한, CLI 모드를 지원하여 스크립트에서 자동화된 청소도 가능합니다. 이 도구의 등장은 AI 코딩 에이전트를 적극적으로 활용하는 개발자들에게 디스크 공간 관리의 효율성을 높여주고, 개발 환경을 쾌적하게 유지하는 데 큰 도움을 줄 것으로 기대됩니다. 이는 AI 도구의 도입이 단순히 생산성 향상을 넘어, 새로운 관리 및 유지보수 도구의 필요성을 야기한다는 점을 보여주는 사례이기도 합니다.