Base package
Install the complete package with local command reference and every published mode.
install diskdisk
pwd/sandboxdir 1 . -Fconfig/
data/
logs/
src/
tmp/disk sandbox/dataPath sandbox/data
Total 1.0 GB
Used 320 MB (31.2%)
Free 704 MBdisk sandbox/data -rPath sandbox/data
Total 1.0 GB
Used 320 MB (31.2%)
Free 704 MBdisk sandbox/images -rPath sandbox/data
Total 1.0 GB
Used 320 MB (31.2%)
Free 704 MB
Overview
Filesystem capacity and directory size are different questions. Use
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.
Syntax
disk [path] [-r]Reference
diskshow filesystem capacity for the current directory
disk <path>show filesystem capacity for the selected file or directory
disk <dir> -ralso measure the contents of the selected directory recursively
Capacity versus directory size
Total, Used and Free refer to the underlying hosting filesystem, not to the selected directory itself. The recursive section appears only with -r and reports item counts plus the measured file bytes below that directory.
Limits
Recursive scanning is bounded and does not follow symbolic links. A scan-limit or unreadable-entry count is reported instead of allowing an unbounded walk through a hosting tree. A trailing slash has no special meaning; use -r when recursive usage is wanted.
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.
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.
Minimum package
Install the reduced package. Local reference is omitted;
install disk -mExact public version
Install exactly this published version.
install disk -v 1.2.1Check or update
Ask upgrade to check compatibility and replace the installed block only when needed.
upgrade diskRemove module
Remove the extension block while leaving the core and unrelated modules intact.
install disk -uExamples
Examples are copyable command lines, not actions executed by this website. Review paths, permissions and destructive flags before running them on a real project.
cd \sandbox | disk . | disk . -r1.0 GB
320 MB (31.2%)
704 MB
18
12
6
0
2.1 KBdisk sandbox/dataPath sandbox/data
Total 1.0 GB
Used 320 MB (31.2%)
Free 704 MBdisk sandbox/data -rPath sandbox/data
Total 1.0 GB
Used 320 MB (31.2%)
Free 704 MB
Items 3
Files 3
Directories 0
Links 0
Size 2.1 KBdisk sandbox/images -rPath sandbox/data
Total 1.0 GB
Used 320 MB (31.2%)
Free 704 MB
Items 3
Files 3
Directories 0
Links 0
Size 2.1 KBdisk \sandbox\missingPath not foundFile 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
Current public release
v1.2.12026-08-09
Explicit recursive disk usage
Current stable release of