dir

Exibe árvores de diretórios com profundidade, máscaras, filtros, ordenação, metadados e totais.

ArquivosVersão 1.2.4Estável
lil-terminal

Visão geral

Use dir quando a visão plana de cd não for suficiente: escolha profundidade, máscaras, filtros de arquivos ou diretórios, agrupamento, ordenação e totais sem depender de ls ou find do sistema.

Ler a estrutura de um diretório com propósito

Profundidade, máscaras e ordenação transformam uma árvore grande em uma pergunta concreta: o que existe, onde está e quais entradas importam?

Sintaxe

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

Referência

dir | dir 1

mostrar árvore de um nível do diretório atual

dir 0 [path]

mostrar lista plana

dir <depth> [path]

mostrar a árvore até a profundidade escolhida

dir -R [path]

mostrar a árvore de forma recursiva

dir [path] <mask>

mostrar arquivos correspondentes e somente os diretórios-pai necessários para alcançá-los

-F | -f

apenas diretórios | apenas arquivos

-p

mostrar caminhos completos

-G | -g

diretórios primeiro | arquivos primeiro

-sum

mostrar totais de diretórios, arquivos, links e tamanho

-a | -A

ordenar por nome crescente | decrescente

-e | -E

ordenar por extensão crescente | decrescente

-d | -D

ordenar por modificação crescente | decrescente

-s | -S

ordenar por tamanho crescente | decrescente

-u

mostrar o proprietário no sistema de arquivos

Colunas e ordenação

Todas as opções começam com -. Em cada par de ordenação, a opção minúscula ordena em ordem crescente e a correspondente maiúscula em ordem decrescente. -d/-D também mostra a data de modificação, -s/-S mostra o tamanho e -u acrescenta o proprietário no sistema de arquivos. Os metadados ficam compactos à esquerda, imediatamente antes do nome ou ramo da árvore; o nome ou caminho recebe a largura restante.

Filtros e máscaras

-F limita a saída a diretórios reais e -f a arquivos regulares; links simbólicos permanecem um tipo de entrada distinto. Uma máscara como "*.php" filtra arquivos e preserva os diretórios-pai necessários para mostrar onde cada correspondência foi encontrada. -p expande os nomes exibidos para caminhos completos do lil-terminal.

Limites

A profundidade é limitada a 20 e cada execução a 5000 itens; diretórios simbólicos não são seguidos.

Prévia interativa do sandbox

Execute os exemplos preparados diretamente na página. Os resultados são predefinidos e exibidos no navegador; nenhum comando do terminal é executado no servidor.

Mostrar a árvore até a profundidade escolhida

Instalar e gerenciar

Instale a versão compatível atual. Escolha Base para o conjunto completo de recursos ou Minimum para o pacote reduzido; use upgrade para atualizar um módulo já instalado.

Base e Minimum são dois pacotes da mesma versão atual do módulo.

Pacote Base

Instala o pacote completo com referência local e todos os modos publicados.

install dir
Pacote Minimum

Instalar o pacote reduzido. A referência local é omitida; help <cmd> -i abre a referência atual do servidor.

install dir -m
Versão pública exata

Instalar exatamente esta versão publicada.

install dir -v 1.2.4
Verificar ou atualizar

upgrade verifica compatibilidade e substitui o bloco somente quando necessário.

upgrade dir
Remover módulo

Remove o bloco da extensão sem afetar o núcleo ou outros módulos.

install dir -u

Exemplos

Os exemplos podem ser copiados, mas o site não os executa. Revise caminhos, permissões e opções destrutivas.

Mostrar a árvore até a profundidade escolhida
cd \sandbox | dir 2 . -G -a
archives
config
  .env.example
  app.ini
  app.json
data
  sample.csv
  sample.txt
  users.json
Mostrar caminhos completos
dir 0 \sandbox -p
/sandbox/archives
/sandbox/config
/sandbox/data
/sandbox/feed.xml
/sandbox/images
Mostrar arquivos correspondentes e somente os diretórios-pai necessários para alcançá-los
dir 3 \sandbox "*.php" -G
src
  Calculator.php
  index.php
scripts
  task.py
Apenas diretórios | apenas arquivos
dir 2 \sandbox -F
archives
config
data
db
images
logs
public
scripts
tmp
workspace
Ordenar por extensão crescente | decrescente
dir 2 \sandbox -f -e
README.txt
feed.xml
new.txt
test.txt
Ordenar por modificação crescente | decrescente
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
Ordenar por tamanho crescente | decrescente
dir 2 \sandbox -S
 39 KB    123.jpg.tar
37.4 KB    123.jpg
1.3 KB    feed.xml
Mostrar o proprietário no sistema de arquivos
dir 1 \sandbox -u
www-data    archives
www-data    config
www-data    feed.xml
Mostrar totais de diretórios, arquivos, links e tamanho
dir 2 \sandbox -sum
archives
config
data
...

Diretórios  10
Arquivos  18
Links  0
Tamanho  44.2 KB
Apenas diretórios | apenas arquivos
dir 2 \sandbox -F -f
Filtros conflitantes

Arquivo usado neste exemplo: sandbox/README.txt

O exemplo usa um arquivo ou diretório do espaço protegido de documentação /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.

Documentação relacionada

Como as operações no sistema de arquivos são protegidas? →Por que arquivos grandes e saídas extensas são limitados? →

Versão pública atual

v1.2.42026-08-13

Metadados mais legíveis

Amplia o espaço antes da coluna de nome e alinha os tamanhos mantendo as unidades padrão B, KB, MB, GB e TB.

# Histórico de versões