file-manager

Open, reveal, search, and inspect local files via Python scripts.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/AP3X-Dev/AGENT --skill file-manager-ap3x-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-manager
Source: https://github.com/AP3X-Dev/AGENT/tree/main/skills/file-manager
Command: npx skills add https://github.com/AP3X-Dev/AGENT --skill file-manager-ap3x-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill provides local file management capabilities, enabling opening files with their default applications, revealing files in the system explorer (Finder on macOS, Explorer on Windows, or the Linux equivalent), and searching for files by name or pattern. It enforces a security policy that requires user approval for operations outside the workspace.

Core Features & Use Cases

  • Open File: Launch a file with its default application.
  • Reveal in Explorer/Finder: Show and select a file in the system file manager.
  • Search for Files: Locate files by name or pattern across directories.
  • Get File Info: Retrieve details such as size, dates, path, and type.

Use Case: You need to quickly access a document or image that is scattered across your drives, reveal it in the file manager, or locate related files without manual navigation.

Quick Start

  • Open a file: python scripts/file_ops.py open "/path/to/document.pdf"
  • Reveal a file: python scripts/file_ops.py reveal "/path/to/file.txt"
  • Search for files: python scripts/file_ops.py search "*.pdf" --location ~/Documents
  • Get file info: python scripts/file_ops.py info "/path/to/file.txt"

Frequently Asked Questions about file-manager

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I open a local file with its default application using a script?

To open a local file, you can use a Python script that calls the system's default application. This file management script handles the open command, allowing you to launch documents or images directly without manual navigation.

Can I reveal a file in Finder or Explorer from the command line?

Yes, you can reveal a file in Finder or Explorer from the command line. The script uses a reveal command to show and select the specified file in your system's native file manager, such as Finder on macOS or Explorer on Windows.

How do I search for files by name or pattern across workspace directories?

You can search for files by name or pattern across workspace directories using a search command. The script locates matching files within specified locations, such as user directories, by accepting a search pattern like "*.pdf".

Does this file management script work across macOS, Windows, and Linux?

Yes, this file management script works across macOS, Windows, and Linux. It implements platform-specific behavior to handle file operations, ensuring compatibility with Finder, Explorer, and equivalent Linux file managers.

Do I need user approval to search for files outside the workspace?

Yes, you need user approval to search for or open files outside the workspace. The script enforces a security policy that requires explicit user approval for any file operations targeting directories outside the current workspace.

How do I get file info such as size, dates, and path?

To get file info such as size, dates, path, and type, you can execute an info command with the target file path. The script retrieves and displays these specific metadata details for the requested file.