---
name: disk-usage
version: 1.0.0
description: >-
  Show disk space usage of a directory, sorted by size. Use when the user wants
  to check how much space files or folders are using.
allowed-tools: Bash(du:*,sort:*,head:*,cut:*)
metadata: >-
  {"openclaw":{"emoji":"💾","requires":{"bins":["du","sort","head","cut"],"env":[]},"install":[]}}
---

# Disk Usage / 디스크 사용량

Show disk space usage of a directory, sorted largest-first.
디렉토리의 디스크 사용량을 크기 순으로 표시합니다.

## Usage / 사용법

```bash
bash run.sh [DIRECTORY]
```

**Arguments / 인수:**
| # | Name | Description | 설명 |
|---|------|-------------|------|
| 1 | DIRECTORY | Directory to check (default: current) | 확인할 디렉토리 (기본값: 현재 디렉토리) |

## Example / 예시

```bash
bash run.sh /home/user/projects
```

**Output / 출력:**
```
DIRECTORY: /home/user/projects
---
ITEM: 1.2G  /home/user/projects/data
ITEM: 340M  /home/user/projects/logs
ITEMS_SHOWN: 2
---
TOTAL: 1.6G
STATUS: OK
```

## Success / Failure — 성공 / 실패

- **Success / 성공**: Item list with TOTAL and `STATUS: OK` (exit code 0) — 항목 목록, 합계, `STATUS: OK` 출력 (종료 코드 0)
- **Failure / 실패**: `ERROR:` message (exit code non-zero) — `ERROR:` 메시지 (종료 코드 0이 아님)