dir

深さ、マスク、フィルター、並べ替え、メタデータ、集計を指定してディレクトリツリーを表示します。

ファイルバージョン 1.2.4安定版
lil-terminal

概要

cd の平面表示では足りないときは dir を使います。システムの lsfind に依存せず、深さ、マスク、ファイル/ディレクトリの絞り込み、グループ化、並び順、集計を指定できます。

目的を持ってディレクトリ構造を読む

深さ・マスク・並べ替えを使うと、大きなツリーを「何があり、どこにあり、どれが重要か」という具体的な問いに絞れます。

構文

lil-terminal
dir [depth] [path] [mask] [options]

リファレンス

dir | dir 1

現在のディレクトリを1階層のツリーで表示

dir 0 [path]

フラット一覧を表示

dir <depth> [path]

選択した深さまでディレクトリツリーを表示する

dir -R [path]

ディレクトリツリーを再帰的に表示する

dir [path] <mask>

一致ファイルと到達に必要な親ディレクトリだけを表示

-F | -f

ディレクトリのみ | ファイルのみ

-p

完全なパスを表示

-G | -g

ディレクトリ優先 | ファイル優先

-sum

ディレクトリ、ファイル、リンク、サイズの合計を表示

-a | -A

名前で昇順 | 降順

-e | -E

拡張子で昇順 | 降順

-d | -D

更新時刻で昇順 | 降順

-s | -S

サイズで昇順 | 降順

-u

ファイルシステム上の所有者を表示

列と並び替え

すべてのオプションは - で始まります。並び替えの各ペアでは、小文字のフラグが昇順、対応する大文字のフラグが降順です。-d/-D は更新時刻、-s/-S はサイズも表示し、-u はファイルシステム上の所有者を追加します。メタデータは名前またはツリー行の直前に左側でコンパクトに表示され、名前またはパスが残りの幅を使います。

フィルターとマスク

-F は実ディレクトリだけ、-f は通常ファイルだけに絞り込み、シンボリックリンクは独立した種類として扱います。"*.php" のようなマスクはファイルを絞り込みつつ、該当箇所を示すために必要な親ディレクトリを残します。-p は表示名を完全な lil-terminal パスに展開します。

制限

深度は20、1回の走査は5000項目までで、シンボリックリンク先のディレクトリは再帰しません。

インタラクティブな sandbox プレビュー

用意された例をページ上でそのまま実行できます。結果は事前に生成されてブラウザに表示され、サーバーではターミナルコマンドを実行しません。

選択した深さまでディレクトリツリーを表示する

インストールと管理

現在の互換バージョンをインストールします。全機能は Base、縮小版は Minimum を選び、すでに導入済みのモジュール更新には upgrade を使います。

Base と Minimum は同じ現在のモジュールリリースの二つのパッケージです。

Base パッケージ

ローカル参照と公開済みの全モードを含む完全パッケージをインストールします。

install dir
Minimum パッケージ

縮小パッケージをインストールします。ローカルリファレンスは含まれず、help <cmd> -i で現在のサーバーリファレンスを開きます。

install dir -m
正確な公開版

この公開済みバージョンを正確に指定してインストールします。

install dir -v 1.2.4
確認または更新

upgrade が互換性を確認し、必要な場合だけブロックを置換します。

upgrade dir
モジュールを削除

コアや他のモジュールに触れず拡張ブロックを削除します。

install dir -u

例はコピーできますが、サイトは実行しません。実プロジェクトではパス、権限、破壊的オプションを確認してください。

選択した深さまでディレクトリツリーを表示する
cd \sandbox | dir 2 . -G -a
archives
config
  .env.example
  app.ini
  app.json
data
  sample.csv
  sample.txt
  users.json
完全なパスを表示
dir 0 \sandbox -p
/sandbox/archives
/sandbox/config
/sandbox/data
/sandbox/feed.xml
/sandbox/images
一致ファイルと到達に必要な親ディレクトリだけを表示
dir 3 \sandbox "*.php" -G
src
  Calculator.php
  index.php
scripts
  task.py
ディレクトリのみ | ファイルのみ
dir 2 \sandbox -F
archives
config
data
db
images
logs
public
scripts
tmp
workspace
拡張子で昇順 | 降順
dir 2 \sandbox -f -e
README.txt
feed.xml
new.txt
test.txt
更新時刻で昇順 | 降順
dir 2 \sandbox -d
2026-08-04 23:20:34    archives
2026-08-08 23:20:40    config
2026-08-08 20:18:28    new.txt
サイズで昇順 | 降順
dir 2 \sandbox -S
 39 KB    123.jpg.tar
37.4 KB    123.jpg
1.3 KB    feed.xml
ファイルシステム上の所有者を表示
dir 1 \sandbox -u
www-data    archives
www-data    config
www-data    feed.xml
ディレクトリ、ファイル、リンク、サイズの合計を表示
dir 2 \sandbox -sum
archives
config
data
...

ディレクトリ数  10
ファイル  18
リンク  0
サイズ  44.2 KB
ディレクトリのみ | ファイルのみ
dir 2 \sandbox -F -f
フィルターが競合しています

この例で使うファイル: sandbox/README.txt

例では、保護されたドキュメント用 /sandbox/ ワークスペースのファイルまたはディレクトリを使います。

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.

関連ドキュメント

現在の公開版

v1.2.42026-08-13

読みやすいメタデータ

名前列の前の間隔を広げ、標準の B、KB、MB、GB、TB を保ったままサイズ表示を揃えます。