| name | gdscript-file-manager |
| description | Move, rename, or delete GDScript files with their .uid files for Godot projects. Use when reorganizing code, renaming scripts, or removing unused GDScript files. |
| allowed-tools | ["Bash"] |
GDScript File Manager
Manage GDScript files (.gd) along with their corresponding .uid files.
Core Principle
Godot Engine auto-generates a .uid file for each resource. Always handle .gd and .uid files together.
Operations
Move Files
ls <destination-dir>
mv <source>.gd <destination>.gd && mv <source>.gd.uid <destination>.gd.uid
ls <destination-dir> && ls <source-dir>
Rename Files
mv <old-name>.gd <new-name>.gd && mv <old-name>.gd.uid <new-name>.gd.uid
ls -la <directory>
Delete Files
ls -la <directory>
rm <filename>.gd && rm <filename>.gd.uid
ls -la <directory>
Important Notes
- Never manually create or edit .uid files - Godot manages them automatically
- Always process both files together to avoid breaking project references
- Verify files before operations using
ls commands
See @examples.md for detailed examples and troubleshooting.