---
title: "List Files"
description: "Local-first visual environment for building and running AI workflows. Build agents visually, deploy anywhere, privacy by design."
canonical: https://docs.nodetool.ai/nodes/lib/os/listfiles
markdown: https://docs.nodetool.ai/nodes/lib/os/listfiles.md
product: NodeTool
source: https://github.com/nodetool-ai/nodetool/blob/main/docs/nodes/lib/os/listfiles.md
---

# List Files

**Type:** `lib.os.ListFiles`

**Namespace:** `lib.os`

## Description

list files in a directory matching a pattern.
    files, list, directory

    Use cases:
    - Get files for batch processing
    - Filter files by extension or pattern

## Properties

| Property | Type | Description | Default |
|----------|------|-------------|---------|
| folder | `str` | Directory to scan | `~` |
| pattern | `str` | File pattern to match (e.g. *.txt) | `*` |
| include_subdirectories | `bool` | Search subdirectories | `false` |

## Outputs

| Output | Type | Description |
|--------|------|-------------|
| file | `str` |  |
| files | `list` |  |

## Related Nodes

Browse other nodes in the [lib.os](./) namespace.