# File Lister

This script scans a directory for files, optionally excluding specific directories and file extensions, and saves the list to a text file.

## Features

* Scan directories recursively
* Exclude specific directories and file extensions
* Save results to a text file
* Verbose mode to include file sizes
* Option to sort files by size

## Usage

```
python true.py [-h] [-o OUTPUT] [--exclude-dirs [EXCLUDE_DIRS ...]]
                [--exclude-extensions [EXCLUDE_EXTENSIONS ...]] [-v] [-s]
                directory
```

### Arguments

* `directory`: Directory to scan for files
* `-o OUTPUT, --output OUTPUT`: Output file name (default: files\_to\_add.txt)
* `--exclude-dirs [EXCLUDE_DIRS ...]`: Directories to exclude
* `--exclude-extensions [EXCLUDE_EXTENSIONS ...]`: File extensions to exclude
* `-v, --verbose`: Enable verbose output (includes file sizes)
* `-s, --sort-by-size`: Sort files by size (largest first)

### Examples

1. Basic usage:

   ```
   python true.py /path/to/directory
   ```
2. Exclude specific directories and file extensions:

   ```
   python true.py /path/to/directory --exclude-dirs .git __pycache__ --exclude-extensions .pyc .tmp
   ```
3. Use verbose mode and sort by size:

   ```
   python true.py /path/to/directory -v -s
   ```
4. Specify custom output file:

   ```
   python true.py /path/to/directory -o my_file_list.txt
   ```

## Requirements

* Python 3.6+

## License

This project is open source and available under the [MIT License](https://github.com/Lesterpaintstheworld/infinite-storyteller/blob/main/LICENSE/README.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.nlr.ai/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.