description: Lists files in the current or a select directory
internal: false

aliases:
  - ls
  - dir

manual:
  summary: |
    This command lists all files that exist in the specific directory, or the current working directory if not specified.

  parameters:
    - name: All
      description: Show hidden files (starting with . or system files)
      required: false

    - name: Search
      value: Query
      description: Search for a specific file containing the query
      required: false

  final:
    name: Dir
    description: The directory or directories to list files of
    required: false
    multiple: true
    command: false
    path: true
    daemon: false

  examples:
    - command: ListDirectory -All
      description: List all the files in the current directory, including hidden files

    - command: ListDirectory /
      description: List all the files in the root directory

  compatibility:
    mistyos: '>=1.0.0'
    kernel: '>=5.10.0'