About

Imported from x-cmd/x-cmd (mod/df/SKILL.md). Install upstream with npx skills add x-cmd/x-cmd --skill df. Copyright stays with the author (Apache-2.0).

x df - Disk Free Space Viewer

Name: x-df
Author: x-cmd

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

{
  "ocm": "1",
  "id": "x-cmd-x-cmd-df",
  "kind": "skill",
  "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).",
  "publisher": "x-cmd",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "data_analysis"
    ],
    "tags": [
      "skill-md",
      "x-cmd",
      "system",
      "df",
      "disk",
      "storage",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "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)."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/x-cmd/x-cmd",
      "path": "mod/df/SKILL.md",
      "ref": "e18c1ef8b4695c7556c4e847b2eb7eaac13b9230",
      "url": "https://github.com/x-cmd/x-cmd/blob/e18c1ef8b4695c7556c4e847b2eb7eaac13b9230/mod/df/SKILL.md",
      "key": "x-cmd/x-cmd/mod/df/SKILL.md"
    },
    "compatibility": "POSIX Shell",
    "license": "Apache-2.0"
  },
  "instructions": "# x df - Disk Free Space Viewer\n\n> Enhanced `df` command combining `df` and `mount` output with multiple formats.\n\n---\n\n## Quick Start\n\n```bash\n# Interactive disk usage viewer (default in TTY)\nx df\n\n# TSV format output (default when piped)\nx df | cat\n```\n\n---\n\n## Features\n\n- **Joint output**: Combines `df` and `mount` command information\n- **Multi-format**: TSV, CSV, TUI application, raw\n- **Cross-platform**: Linux, macOS, Windows support\n- **Auto-detection**: Interactive mode in TTY, TSV when piped\n\n---\n\n## Output Fields\n\n### Linux / Windows\n\n| Field | Description | Example |\n|-------|-------",
  "cost": {
    "context_tokens": 751
  }
}

Fetch it by URL: GET /api/v1/registry/x-cmd-x-cmd-df/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.

x-df