disk

disk reports filesystem capacity for a path; with -r it separately measures the contents of a directory.

DiagnosticsVersion 1.2.3Stable
lil-terminal

Overview

Filesystem capacity and directory size are different questions. Use disk <path> for the hosting volume and add -r only when you also need a bounded recursive measurement.

Filesystem capacity versus directory size

A file or directory lives inside a filesystem. Total, Used and Free describe that whole filesystem, while a directory size describes only the files below one path. disk keeps those measurements separate; recursive scans are bounded and do not follow symbolic links.

Syntax

lil-terminal
disk [path] [-r] [-b]

Reference

disk

show filesystem capacity for the current directory

disk <path>

show filesystem capacity for the selected file or directory

disk <dir> -r

also measure the contents of the selected directory recursively

-r

scan directory contents without following links

-b

show exact byte values

Interactive sandbox preview

Run the prepared examples directly on the page. Their results are prebuilt and shown in the browser; no terminal command is executed on the server.

Compare filesystem capacity and directory size

Install and manage

Install the current compatible version. Choose Base for the complete feature set or Minimum for the reduced package; use upgrade to update a module that is already installed.

Base and Minimum are two packages of the same current module release, not separate command versions.

Base package

Install the complete package with local command reference and every published mode.

install disk
Minimum package

Install the reduced package. Local reference is omitted; help <cmd> -i opens the current server reference.

install disk -m
Exact public version

Install exactly this published version.

install disk -v 1.2.3
Check or update

Ask upgrade to check compatibility and replace the installed block only when needed.

upgrade disk
Remove module

Remove the extension block while leaving the core and unrelated modules intact.

install disk -u

Examples

Examples are copyable command lines, not actions executed by this website. Review paths, permissions and destructive flags before running them on a real project.

Compare filesystem capacity and directory size
disk
Training snapshot — host, time and storage values vary by server
Path   sandbox
Total  31.5 GB
Used   1.7 GB (5.5%)
Free   29.7 GB
Show filesystem capacity for the selected file or directory
disk sandbox
Training snapshot — host, time and storage values vary by server
Path   sandbox/
Total  31.5 GB
Used   1.7 GB (5.5%)
Free   29.7 GB
Show filesystem capacity for the selected file or directory
disk sandbox/config
Training snapshot — host, time and storage values vary by server
Path   sandbox/config
Total  31.5 GB
Used   1.7 GB (5.5%)
Free   29.7 GB
Show filesystem capacity for the selected file or directory
disk sandbox/config/app.ini
Training snapshot — host, time and storage values vary by server
Path   sandbox/config/app.ini
Total  31.5 GB
Used   1.7 GB (5.5%)
Free   29.7 GB
Handle a missing path
disk sandbox/data
Training snapshot — host, time and storage values vary by server
Path   sandbox/data
Total  31.5 GB
Used   1.7 GB (5.5%)
Free   29.7 GB
Also measure the contents of the selected directory recursively
disk sandbox/data -r
Training snapshot — host, time and storage values vary by server
Path         sandbox/data
Total        31.5 GB
Used         1.7 GB (5.5%)
Free         29.7 GB

Items        3
Files        3
Directories  0
Links        0
Size         261 B (261 b)
Also measure the contents of the selected directory recursively
disk sandbox/images -r
Training snapshot — host, time and storage values vary by server
Path         sandbox/images
Total        31.5 GB
Used         1.7 GB (5.5%)
Free         29.7 GB

Items        4
Files        4
Directories  0
Links        0
Size         1.8 KB (1 840 b)
Also measure the contents of the selected directory recursively
disk sandbox/config -r
Training snapshot — host, time and storage values vary by server
Path         sandbox/config
Total        31.5 GB
Used         1.7 GB (5.5%)
Free         29.7 GB

Items        20
Files        20
Directories  0
Links        0
Size         513.5 KB (525 857 b)
Show exact byte values
disk sandbox/data -b
Training snapshot — host, time and storage values vary by server
Path   sandbox/data
Total  33 770 192 896 B
Used   1 872 125 952 B (5.5%)
Free   31 898 066 944 B
Also measure the contents of the selected directory recursively
disk sandbox/data -r -b
Training snapshot — host, time and storage values vary by server
Path         sandbox/data
Total        33 770 192 896 B
Used         1 872 125 952 B (5.5%)
Free         31 898 066 944 B

Items        3
Files        3
Directories  0
Links        0
Size         261 B
Show exact byte values
disk sandbox -b
Training snapshot — host, time and storage values vary by server
Path   sandbox/
Total  33 770 192 896 B
Used   1 872 125 952 B (5.5%)
Free   31 898 066 944 B
Also measure the contents of the selected directory recursively
disk sandbox/config/app.ini -r
Training snapshot — host, time and storage values vary by server
Recursive usage requires a directory
Show filesystem capacity for the selected file or directory
disk sandbox/not-found
Training snapshot — host, time and storage values vary by server
Path not found
Show filesystem capacity for the selected file or directory
disk sandbox/data -z
Training snapshot — host, time and storage values vary by server
Unknown option: -z
Show filesystem capacity for the selected file or directory
disk sandbox/data sandbox/images
Training snapshot — host, time and storage values vary by server
?
Also measure the contents of the selected directory recursively
disk sandbox/config -b -r
Training snapshot — host, time and storage values vary by server
Path         sandbox/config
Total        33 770 192 896 B
Used         1 872 125 952 B (5.5%)
Free         31 898 066 944 B

Items        20
Files        20
Directories  0
Links        0
Size         525 857 B

File used in this example: sandbox/README.txt

The example uses a file or directory from the protected /sandbox/ documentation workspace.

lil-terminal documentation sandbox

This directory is part of the server tree: website_e36e9fed/sandbox/.
It is never included in generated lil-terminal downloads and direct HTTP access is blocked.
The documentation renderer reads only explicitly allow-listed files from here and
uses them to show real, reproducible command examples.

The fixtures are intentionally small and contain no secrets. They cover PHP, HTML,
CSS, JavaScript, JSON, INI, SQL, Python, shell, XML/SVG, CSV, plain text, logs,
images, .lil workflows, archives and temporary work paths.

During module review, examples may be refined together with the command. Keep paths
stable whenever possible because public documentation links refer to them.

Related documentation

What are the server requirements? →Why are large files or outputs limited? →

Current public release

v1.2.32026-10-31

Exact byte totals

disk -b reports exact filesystem byte counts, and combines with -r for exact recursive usage.

# Version history