CodeGroup - File Organizer
Organize scattered files into named groups – like bookmarks for your codebase.
⚡ What It Does
- 📁 Create custom file groups – Group related files from any folder into named collections
- 🎨 Customize with colors & icons – 120+ icons, hex colors, badges visible in tabs & explorer
- 🖱️ Drag & drop everything – Files, folders, groups, subgroups – all draggable
🚀 Quick Start
- Click the File Groups icon (📦) in the Activity Bar
- Click + to create a new group
- Drag files from Explorer into your group
- Done! Click a file to open it, or "Open All" to open the entire group
✨ Features
📁 Groups & Subgroups
- Create named groups to organize related files
- Create subgroups for hierarchical organization (e.g., "Backend" → "API", "Database")
- Add files from any folder in your workspace
- Multi-select support: add multiple files at once
🎨 Customization
- 120+ icons: folder, rocket, flame, star, key, database, and more
- Colors: 9 predefined colors OR any custom hex color (e.g.,
#FF5733)
- Badges: Custom 1-2 character badge for file decorations
- Descriptions: Add notes with Markdown support
🖱️ Drag & Drop
- Drag files from Explorer into groups
- Drag tabs into groups
- Drag groups onto other groups to create subgroups
- Drag subgroups to empty space to move them back to root
- Reorder files within groups
⚡ Quick Actions
- Open All: Open all files in a group (including subgroups)
- Close All: Close only files from a specific group
- Pin groups: Keep important groups at the top (📌)
- Expand/Collapse All: Quick navigation in title bar
🔄 Smart File Tracking
- Auto-handles file renames – files stay in groups with updated names
- Auto-removes deleted files from groups
- "Clean Up Missing Files" command for manual cleanup
- Auto-cleanup prompt on startup
💾 Git-Friendly Storage
- Groups saved to
.vscode/file-groups.json
- Share group configs with your team via Git
- Relative paths for cross-machine compatibility
- Creator attribution – see who set up each group
📋 Commands
All commands available via Command Palette (Ctrl+Shift+P):
| Command |
Description |
File Groups: Create Group |
Create a new root file group |
File Groups: Create Subgroup |
Create a subgroup under selected group |
File Groups: Delete Group... |
Delete a group (with picker) |
File Groups: Edit Summary |
Set short description for a group |
File Groups: Edit Description |
Add longer Markdown notes |
File Groups: Pin/Unpin Group |
Pin group to top |
File Groups: Set Badge Text |
Custom badge for file decorations |
File Groups: Find Duplicate Files |
Find files in multiple groups |
File Groups: Clean Up Missing Files |
Remove deleted files |
File Groups: Expand/Collapse All |
Navigation helpers |
📸 Screenshots
Main View
Groups are saved to .vscode/file-groups.json:
{
"version": 2,
"groups": [
{
"id": "abc123",
"name": "Authentication",
"icon": "key",
"color": "#3498DB",
"shortDescription": "Login endpoints",
"files": [
{ "path": "src/auth/login.ts", "name": "login.ts" }
]
}
]
}
📦 Requirements
🐛 Known Issues
None at this time. Please report issues on GitHub.
📝 Release Notes
See CHANGELOG.md for full release history.
1.0.7
- Removed test infrastructure to reduce package size
- Optimized icon size from 14.6kb to 5.5kb
🤝 Contributing
Contributions are welcome! See CONTRIBUTING.md for guidelines.
📄 License
MIT License
⭐ If you find this extension useful, please leave a review on the VS Code Marketplace!
