Overview Version History Q & A Rating & Review
See My Folder Structure
A lightweight, powerful Visual Studio Code extension that generates a complete representation of your directory structure.
Perfect for:
📄 Documentation: Quickly adding project structure to your README.md.
🤖 AI Context: Generating a clean file structure to copy-paste into ChatGPT, Claude, or other AI agents to explain your project architecture.
📦 Project Handover: Helping new team members understand the file hierarchy.
🚀 Features
Dual Formats: Generate either a classic ASCII Text Tree or a structured JSON file.
Auto-Save: Automatically saves the output as folder-structure.txt or folder-structure.json in your root directory.
Large Project Support: Includes a real-time progress bar with percentage tracking (10%, 50%, etc.) for handling massive repositories.
Smart Detection: Works on the currently open workspace, or prompts you to select a folder if no workspace is open.
Clean Output: Automatically ignores its own output files to prevent recursion loops.
Cancellable: Stop the scan at any time using the "Cancel" button in the progress notification.
📖 How to Use
Open the Command Palette:
Windows/Linux: Ctrl + Shift + P
Mac: Cmd + Shift + P
Type and select: Generate Folder Structure
Choose your output format:
Text Tree: For visual ASCII art.
JSON: For programmatic use or data parsing.
The extension will scan your folder and save the file.
The generated file will open automatically in the editor.
📝 Example Output
Option 1: Text Tree (folder-structure.txt)
my-project
├── src
│ ├── components
│ │ ├── Header.tsx
│ │ └── Footer.tsx
│ ├── utils
│ │ └── api.ts
│ └── index.ts
├── package.json
└── README.md
Option 2: JSON (folder-structure.json)
JSON
{
"name": "my-project",
"type": "directory",
"children": [
{
"name": "src",
"type": "directory",
"children": [
{
"name": "index.ts",
"type": "file"
}
]
},
{
"name": "package.json",
"type": "file"
}
]
}
⚙️ Requirements
Visual Studio Code version 1.80.0 or higher.
🔧 Extension Settings
This extension currently runs with zero configuration. It automatically detects your folder structure.
📅 Release Notes
0.0.1
Initial release.
Added ASCII and JSON format support.
Added progress bar with percentage tracking.
Added file saving capability.
Enjoying the extension? Please consider leaving a review on the Marketplace!