https://github.com/akaiko1/file-tree-scanner
A cross-platform GUI application for scanning directory structures and generating formatted file trees, designed to provide clear project structure snapshots for AI agents.
Science Score: 26.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
○Academic publication links
-
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (13.0%) to scientific vocabulary
Keywords
Repository
A cross-platform GUI application for scanning directory structures and generating formatted file trees, designed to provide clear project structure snapshots for AI agents.
Statistics
- Stars: 0
- Watchers: 0
- Forks: 1
- Open Issues: 0
- Releases: 2
Topics
Metadata Files
README.md
File Tree Scanner 🌳
⚠️ Work In Progress - This project is under active development.
A cross-platform GUI application for scanning directory structures and generating formatted file trees, designed to provide clear project structure snapshots for AI agents.

Purpose
This tool creates clean, formatted directory trees specifically for explaining project structures to AI agents like ChatGPT, Claude, and others. When you need to share your project layout with an AI for code reviews, architecture discussions, or development help, this scanner provides the perfect format.
Example Output
```
File Tree for: C:/Github/MyProject
📁 src/ ├── 📁 components/ │ ├── 📄 Header.jsx │ ├── 📄 Footer.jsx │ └── 📄 Navigation.jsx ├── 📁 utils/ │ ├── 📄 helpers.js │ └── 📄 constants.js └── 📄 App.jsx ├── 📄 package.json ├── 📄 README.md └── 📄 .gitignore ```
Installation
Windows (Pre-built Binary)
- Download
file-tree-scanner.exefrom Releases - Run the executable
- No additional installation required
Build from Source (All Platforms)
Prerequisites: Go 1.21+ and Fyne dependencies
Install Fyne Prerequisites: ```bash
Linux (Ubuntu/Debian)
sudo apt-get install gcc pkg-config libgl1-mesa-dev libxcursor-dev libxrandr-dev libxinerama-dev libxi-dev
macOS
xcode-select --install
Windows
Install TDM-GCC: https://jmeubank.github.io/tdm-gcc/
Or install Go with CGO support and ensure gcc is in PATH
```
Install with go install
```bash
Ensure $GOPATH/bin is in your PATH
go install github.com/Akaiko1/file-tree-scanner/cmd@latest ```
Or use manual Build: ```bash git clone https://github.com/Akaiko1/file-tree-scanner.git cd file-tree-scanner go mod tidy
Linux/macOS
go build -o file-tree-scanner ./cmd
Windows (GUI - no console)
go build -ldflags="-H windowsgui" -o file-tree-scanner.exe ./cmd
Windows (using PowerShell build script)
.\build.ps1 ```
Usage
- Launch the application
- Click "📁 Select Folder" to choose a directory
- Or just drag & drop the folder onto the app's active window
- Copy the generated tree with "📋 Copy to Clipboard"
- Paste into your AI conversation to explain your project structure
Perfect for sharing project layouts with AI agents for code reviews, architecture discussions, and development assistance.
Owner
- Name: Akaiko
- Login: Akaiko1
- Kind: user
- Repositories: 1
- Profile: https://github.com/Akaiko1
GitHub Events
Total
- Release event: 1
- Push event: 4
- Fork event: 1
- Create event: 1
Last Year
- Release event: 1
- Push event: 4
- Fork event: 1
- Create event: 1
Packages
- Total packages: 1
- Total downloads: unknown
- Total dependent packages: 0
- Total dependent repositories: 0
- Total versions: 0
proxy.golang.org: github.com/Akaiko1/file-tree-scanner
Rankings
Dependencies
- fyne.io/fyne/v2 v2.6.0
- fyne.io/systray v1.11.0
- github.com/BurntSushi/toml v1.4.0
- github.com/davecgh/go-spew v1.1.1
- github.com/fredbi/uri v1.1.0
- github.com/fsnotify/fsnotify v1.7.0
- github.com/fyne-io/gl-js v0.1.0
- github.com/fyne-io/glfw-js v0.2.0
- github.com/fyne-io/image v0.1.1
- github.com/fyne-io/oksvg v0.1.0
- github.com/go-gl/gl v0.0.0-20231021071112-07e5d0ea2e71
- github.com/go-gl/glfw/v3.3/glfw v0.0.0-20240506104042-037f3cc74f2a
- github.com/go-text/render v0.2.0
- github.com/go-text/typesetting v0.2.1
- github.com/godbus/dbus/v5 v5.1.0
- github.com/hack-pad/go-indexeddb v0.3.2
- github.com/hack-pad/safejs v0.1.0
- github.com/jeandeaual/go-locale v0.0.0-20241217141322-fcc2cadd6f08
- github.com/jsummers/gobmp v0.0.0-20230614200233-a9de23ed2e25
- github.com/kr/text v0.2.0
- github.com/nfnt/resize v0.0.0-20180221191011-83c6a9932646
- github.com/nicksnyder/go-i18n/v2 v2.5.1
- github.com/pmezard/go-difflib v1.0.0
- github.com/rymdport/portal v0.4.1
- github.com/srwiley/oksvg v0.0.0-20221011165216-be6e8873101c
- github.com/srwiley/rasterx v0.0.0-20220730225603-2ab79fcdd4ef
- github.com/stretchr/testify v1.10.0
- github.com/yuin/goldmark v1.7.8
- golang.org/x/image v0.24.0
- golang.org/x/net v0.35.0
- golang.org/x/sys v0.30.0
- golang.org/x/text v0.22.0
- gopkg.in/yaml.v3 v3.0.1