tree-view

Tree View

Fast directory tree visualization using fd + Python3.

When to Use

• Need a quick overview of directory structure
• Want to see files organized hierarchically
• Default tree command is not available or too slow
• Need customizable depth limits

Usage

# Show directory tree (default 2 levels)
bun ~/.pi/agent/skills/tree-view/cli.ts

# Show 3 levels deep
DEPTH=3 bun ~/.pi/agent/skills/tree-view/cli.ts

Show 4 levels deep

DEPTH=4 bun ~/.pi/agent/skills/tree-view/cli.ts

## Features

- **Fast**: Uses `fd` for efficient file discovery
- **Depth control**: Environment variable `DEPTH` controls levels
- **Clean output**: Proper tree structure with branch characters
- **Smart truncation**: Long filenames are truncated for readability

## Requirements

- `bun` - Bun runtime
- `fd` - Fast alternative to `find`
- `python3` - For tree formatting

## Output Format

docs/ ├── adr/ │ └── 20240210-decision.md ├── issues/ │ ├── frontend/ │ │ └── 20240210-task.md │ └── backend/ └── guides/

## Notes

- Directories are shown with trailing `/`
- Files are shown without trailing slash
- Names longer than 30 characters are truncated (`prefix...suffix`)