| name | diskspace |
| description | 디스크 공간 분석 — 마운트 요약, 디렉토리별 크기, 큰 파일 찾기, NixOS 스토어 분석, 정리 제안. ncdu/du 대신 에이전트 친화적 CLI. Use when disk is full, finding large files, cleanup suggestions, or 'diskspace', '디스크', '용량', '공간', 'storage'. |
diskspace v0.1.0 — Agent-Friendly Disk Analyzer
에이전트가 디스크 공간을 빠르게 파악하기 위한 스킬.
gdu(Go 병렬 스캔) + duf + fd + nix 명령 조합.
Script: {baseDir}/scripts/diskspace.sh
Commands
overview — 마운트 포인트 요약 (즉시)
{baseDir}/scripts/diskspace.sh overview
duf --json 기반. 어떤 파티션이 꽉 찼는지 즉시 확인.
top — 큰 디렉토리 정렬 (10-15초)
{baseDir}/scripts/diskspace.sh top ~
{baseDir}/scripts/diskspace.sh top ~/repos
{baseDir}/scripts/diskspace.sh top /
gdu -n -p -c 사용. du보다 4배 빠름 (Go 병렬 처리).
루트(/) 스캔 시 /nix/store는 자동 제외 — nix 서브커맨드로 별도 분석.
bigfiles — 큰 파일 찾기 (0.5초)
{baseDir}/scripts/diskspace.sh bigfiles ~
{baseDir}/scripts/diskspace.sh bigfiles ~/repos --min 500M
{baseDir}/scripts/diskspace.sh bigfiles ~ --min 1G
fd --size 사용. 가장 빠른 서브커맨드.
nix — NixOS 스토어 분석 (1-15초)
{baseDir}/scripts/diskspace.sh nix
시스템 클로저 크기, store path 수, GC roots, 세대 수, result 심볼릭 링크 등.
clean — 정리 제안 (즉시)
{baseDir}/scripts/diskspace.sh clean
디스크 사용률, nix 세대, 캐시, 큰 파일 등 종합 분석 후 정리 명령 제안.
Workflow
- "디스크 부족" →
overview 먼저 (즉시)
- 어디가 큰지 →
top PATH (10-15초)
- 빠른 승리 →
bigfiles (0.5초)
- NixOS 정리 →
nix (1-15초)
- 종합 제안 →
clean (즉시)
Dependencies
gdu — Go 병렬 디스크 스캐너 (nixpkgs#gdu)
duf — 마운트 요약 (이미 설치)
fd — 파일 검색 (이미 설치)
jq — JSON 파싱 (이미 설치)