# @vladstudio/pi-file-tree

Pi extension adding a `file_tree` tool: ASCII tree of a path.

- Omit `depth` → expands to the deepest level fitting 400 lines.
- Folders-only by default; `includeFiles` adds files.
- `includeHidden` adds dotfiles (`.gitignore`, `.env`).
- `├──` / `└──` connectors.
- Excludes `node_modules`, `dist`.
- Text files show size and line count.

## Parameters

| param | type | default | description |
|---|---|---|---|
| `path` | string | — | Path (relative or absolute) |
| `includeFiles` | boolean | `false` | Include files (default: folders only) |
| `includeHidden` | boolean | `false` | Include dotfiles/dotdirs |
| `depth` | number | auto | Max depth; unset → auto-expand to fit |

## Install

```bash
pi install npm:@vladstudio/pi-file-tree
```

## Example

```
5 folder(s), 17 file(s)
extensions
├─ biome
│  └─ index.ts · 3Kb · 124 lines
├─ skim
│  ├─ index.ts · 19Kb · 670 lines
│  └─ package.json · 160b · 10 lines
└─ web_fetch
   └─ index.ts · 3Kb · 90 lines
```

## License

MIT