File Manager Skill

This skill provides file management operations on the local system. It can open files, reveal them in the file explorer, and search for files.

⚠️ Security Note

Operations on files outside the workspace require user approval. The agent will pause and ask for confirmation before:

• Opening files outside the current project
• Revealing files in external locations
• Executing any file operations on system directories

When to Use

• User asks to "open" a document, image, or file
• User wants to "show in explorer" or "reveal in finder"
• User needs to find a file on their system
• User asks about file details (size, dates, type)

Available Commands

Open File

Opens a file with its default application.

python scripts/file_ops.py open "/path/to/document.pdf"

Examples:

• Open a PDF: open ~/Documents/report.pdf
• Open an image: open ./screenshot.png
• Open a URL: open https://example.com

Reveal in Explorer/Finder

Shows the file in the system file manager, with the file selected.

python scripts/file_ops.py reveal "/path/to/file.txt"

Search for Files

Search for files by name or pattern.

python scripts/file_ops.py search "*.pdf" --location ~/Documents
python scripts/file_ops.py search "report" --location ~/Documents --recursive

Get File Info

Get detailed information about a file.

python scripts/file_ops.py info "/path/to/file.txt"

Returns: size, creation date, modification date, file type, permissions.

Platform Support

Operation	Windows	macOS	Linux
Open file	✅ os.startfile	✅ open	✅ xdg-open
Reveal	✅ explorer /select	✅ open -R	✅ xdg-open (folder)
Search	✅ dir /s	✅ mdfind	✅ find

Notes

• File paths can be absolute or relative to current directory
• Use forward slashes / or escaped backslashes \\ on Windows
• URLs are also supported for the open command
• Search is case-insensitive on Windows and macOS