x-df

x-df是x-cmd旗下的增强版磁盘工具，整合原生df的磁盘使用信息与mount的挂载属性，支持TUI交互式查看、CSV/TSV结构化输出及原始格式。跨平台兼容Linux、macOS、Windows，可自动适配终端（交互式）或管道（TSV）场景。适用于查看磁盘空间与挂载详情，筛选大容量分区，或导出数据做二次处理，输入为命令行参数，输出依需求呈现对应格式。

edwinjhlee

热度 57.65

最近更新 2026-05-11 17:30:16

分类：效率依赖：代码执行应用场景：DevOps / 数据处理

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add x-df

Metadata

name: x-df
description: Enhanced `df` combining disk usage and mount info. Supports CSV, TSV, and TUI with filesystem type detection. **Dependency**: This is an x-cmd module. Install x-cmd first (see x-cmd skill for installation options).
license: Apache-2.0
compatibility: POSIX Shell
metadata: {"author":"Li Junhao","version":"1.0.2","category":"x-cmd-extension","tags":["x-cmd","system","df","disk","storage"]}

x df - Disk Free Space Viewer

Enhanced df command combining df and mount output with multiple formats.

Quick Start

# Interactive disk usage viewer (default in TTY)
x df

# TSV format output (default when piped)
x df | cat

Features

Joint output: Combines df and mount command information
Multi-format: TSV, CSV, TUI application, raw
Cross-platform: Linux, macOS, Windows support
Auto-detection: Interactive mode in TTY, TSV when piped

Output Fields

Linux / Windows

Field	Description	Example
`Filesystem`	Device path	`/dev/sda1`
`Type`	Filesystem type	`ext4`, `ntfs`
`Size`	Total size	`500G`
`Used`	Used space	`200G`
`Avail`	Available space	`300G`
`Use%`	Usage percentage	`40%`
`Mounted_path`	Mount point	`/`, `/home`
`Mounted_attr`	Mount attributes	`rw,relatime`

macOS (additional fields)

Field	Description	Example
`Capacity`	Capacity percentage	`40%`
`iused`	Used inodes	`1000000`
`ifree`	Free inodes	`9000000`
`%iused`	Inode usage %	`10%`

Commands

Command	Description
`x df`	Auto mode: TTY→interactive, pipe→TSV
`x df --app`	Interactive TUI view
`x df --csv`	CSV format output
`x df --tsv`	TSV format output
`x df --raw`	Raw system command output
`x df --numeric`	Display sizes in pure numeric form

Examples

Basic Usage

# Interactive view (TTY)
x df

# TSV format
x df --tsv

# CSV format
x df --csv

Filter and Process

# Find large filesystems (>100GB)
x df --tsv | awk -F'\t' 'NR>1 && $3 > 100'

# Check specific mount point
x df --tsv | grep "/home"

# Get usage percentages only
x df --tsv | awk -F'\t' '{print $1, $6}'

Data Processing

# Convert to JSON via csv
x df --csv | x csv tojson

# SQL-like query on disk usage
x df --csv | x csv sql "SELECT * WHERE Use% > 80"

Platform Notes

Linux

Uses df and /proc/mounts or mount command
Full feature support

macOS

Uses df and mount command
Additional inode information (iused, ifree, %iused)

Windows

Uses wmic or PowerShell Get-Volume for disk info
Full feature support

Comparison with Native df

Command	Output
`df -h`	Basic disk usage
`mount`	Mount information
`x df`	Combined view with filesystem type and mount attributes

# Native df
$ df -h
Filesystem      Size  Used Avail Use% Mounted on
/dev/sda1       500G  200G  300G  40% /

# x df (combined with mount info)
$ x df --tsv
Filesystem    Type    Size    Used    Avail   Use%    Mounted_path    Mounted_attr
/dev/sda1     ext4    500G    200G    300G    40%     /               rw,relatime

Native df(1) manual page
Native mount(8) manual page