Folder Mapper is a tool to generate snapshots of a folder structure. It's the perfect tool for providing AI agents with a project overview or sharing your project's architecture with team members.
🔽 Download the VSCode Extension from the Marketplace: Folder Mapper
Features
🆓 Free Forever: No premium features, everything is included for free.
📊 Text-Based Mapping: Generate a detailed map of your folder structure in a .txt format.
💡 Token Cost Estimation: Estimates the token cost of the output when given to AI as a prompt.
🔍 Depth Control: Focus on specific project levels by setting a mapping depth limit.
🚫 Smart Exclusions: Automatically exclude files and directories using custom ignore files.
⚡ Efficient Performance: Fast mapping, even for large projects.
🖥️ User-Friendly Interface: Sleek, sidebar interface for easy navigation.
🎨 Theme-Aware Design: UI adapts to match your VS Code theme.
📘 Integrated Guide: In-depth documentation to help you explore each feature.
How to Use
Open the Folder Mapper sidebar in VS Code.
Click "Select Folder to Map" to choose the folder you want to map.
(Optional) Click "Select Output Folder" to choose where to save the map file.
(Optional) Set the "Depth Limit" if you want to restrict the mapping depth (0 for unlimited).
(Optional) Select an ignore file from the dropdown menu to exclude specific files or directories.
(Optional) Toggle the "AI-Optimized Structure" option for a more compact output suitable for AI language models.
Click "Start Mapping" to generate the folder structure map.
Refer to the "Guide" tab for detailed explanations of each feature.
Folder Mapper in action:
Requirements
This extension requires Visual Studio Code version 1.93.0 or higher.
Extension Settings
Folder Mapper works out of the box with no additional configuration required!
Known Issues
There are no known issues at this time. If you encounter any problems, please report them on our GitHub issues page.
New in Version 1.9
Token cost comparison feature: now shows the difference between current and previous mapping token costs
Visual indicators for token cost changes (green for decreases, red for increases)
.txt outcome of a mapped folder
