docs: add fuzzy search (#3357)

documentation/docs/guides/file-management.md

@@ -1,12 +1,42 @@
 ---
-title: File Management
+title: File Access and Management
 sidebar_position: 10
 sidebar_label: File Management
+description: Efficiently find and reference files in Goose Desktop and follow best practices for safe file operations
 ---
 
-As an autonomous agent, Goose is designed to carry out tasks following specified instructions. This may sometimes involve working with local files. It's essential to follow best practices for safe file modification to monitor changes and revert anywhere necessary.
+As an autonomous agent, Goose is designed to carry out tasks following specified instructions. This often involves working with local files - both finding the right files to work with and modifying them safely.
 
-Here are a few tips to help you manage file operations effectively while maintaining the integrity and safety of your codebase.
+This guide covers how to efficiently access and reference files in Goose. It also includes essential best practices for safe file operations, such as monitoring changes and reverting them when necessary, to maintain the integrity of your codebase.
+
+## File Access
+
+### Quick File Search in Goose Desktop
+
+Goose Desktop includes a fuzzy file search feature that makes it easy to reference files from within the chat interface without manually navigating through file system dialogs. This feature helps you quickly find and include files in your messages to Goose.
+
+1. Type `@` in the chat input to open the file search box
+2. Continue typing to filter files using case-insensitive, fuzzy matching (e.g., `@readme`, `@config.js`, `@src/main`)
+
+   Navigate the results:
+   - Use arrow keys (↑/↓) to move through the search results
+   - Click or press `Enter` to insert the selected file path into your message
+   
+3. That's it! When you're ready, send your message to Goose
+
+:::info
+To close the search box without selecting a file, press `Esc` or click in the chat input.
+:::
+
+**Smart features:**
+- **Fuzzy matching**: Intelligently matches partial text and prioritizes matches at word boundaries
+- **Highlighted results**: Shows matched characters highlighted in the search results
+- **Performance optimized**: Scans up to 5 directory levels deep with intelligent filtering
+- **Auto-filtering**: Automatically excludes common directories like `.git`, `node_modules`, `__pycache__`, `.vscode`, `.idea`, `target`, `dist`, and `build`
+- **Cross-platform**: Searches from user directories (`/Users` on macOS, `C:\Users` on Windows, `/home` on Linux)
+- **Visual indicators**: Distinguishes between files and directories with clear icons
+
+## File Management Best Practices
 
 ### Version Control