How do I install the X Df skill?

Run npx skillmds@latest add x-cmd/x-df in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with X Df?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free. This skill is licensed under Apache-2.

x-cmd (@x-cmd) published this skill. Their other Agent Skills are listed on their SkillMD profile.

X Df by x-cmd — Agent Skill

Name: X Df
Author: x-cmd

File contents

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

---name: x-dfdescription: 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---# x df - Disk Free Space Viewer> Enhanced `df` command combining `df` and `mount` output with multiple formats.---## Quick Start```bash# 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```bash# Interactive view (TTY)x df# TSV formatx df --tsv# CSV formatx df --csv```### Filter and Process```bash# Find large filesystems (>100GB)x df --tsv | awk -F'\t' 'NR>1 && $3 > 100'# Check specific mount pointx df --tsv | grep "/home"# Get usage percentages onlyx df --tsv | awk -F'\t' '{print $1, $6}'```### Data Processing```bash# Convert to JSON via csvx df --csv | x csv tojson# SQL-like query on disk usagex 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 |```bash# Native df$ df -hFilesystem Size Used Avail Use% Mounted on/dev/sda1 500G 200G 300G 40% /# x df (combined with mount info)$ x df --tsvFilesystem Type Size Used Avail Use% Mounted_path Mounted_attr/dev/sda1 ext4 500G 200G 300G 40% / rw,relatime```---## Related- Native `df(1)` manual page- Native `mount(8)` manual page

Frequently asked questions

X Df