A high-performance macOS file search skill providing millisecond indexing, metadata filtering, and deep automation capabilities.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install profind
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install profind using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is ProFind macOS File Search?
The ProFind skill is a sophisticated file search wrapper for macOS, bridging the gap between raw file system queries and high-level automation. By leveraging millisecond-level Spotlight indexing alongside traditional file system scanning, it ensures that no file remains hidden, even in unindexed locations. This utility is a core component for those extending their workspace through Openclaw Skills.
This tool is essential for developers and power users who need to programmatically interact with their local storage. Through its support for URL schemes, AppleScript, and shell hooks, it enables seamless integration into broader automation workflows. Utilizing this capability allows AI agents to locate and manipulate files with precision based on complex criteria like file size, modification date, or deep metadata.
ProFind macOS File Search Use Cases
- Locating project files across large repositories using glob or regex patterns.
- Performing full-text content searches for specific keywords within documents or source code.
- Filtering files by advanced metadata such as UTI, author, or custom Spotlight tags.
- Automating batch file operations like moving, renaming, or mailing files through script hooks.
- Triggering UI-based search windows from automated CLI environments for Openclaw Skills users.
How ProFind macOS File Search Works
- The skill receives a search query which can include filename, content, or metadata parameters.
- It automatically determines the most efficient search strategy, preferring Spotlight for speed but falling back to system scans for unindexed paths.
- A URL scheme or AppleScript command is constructed and executed to interface with the ProFind application.
- Results are processed and can be optionally passed to custom shell or AppleScript hooks for secondary actions.
- Advanced users can query the internal Media Server via the HTTP API for programmatic results retrieval.
ProFind macOS File Search Setup
Ensure ProFind is installed on macOS (10.14+). You can check installation status via the CLI:
if [ -d "/Applications/ProFind.app" ]; then
echo "ProFind is installed"
else
echo "ProFind not found. Please install from the App Store."
fi
To allow Openclaw Skills to search system folders, you must grant Full Disk Access to ProFind in System Settings > Privacy & Security.
ProFind macOS File Search Data Schema & Taxonomy
The skill interacts with the macOS file system and manages metadata through the following taxonomy:
| Component | Path / Detail |
|---|---|
| Application | /Applications/ProFind.app |
| User Scripts | ~/Library/Scripts/ProFind/ |
| Index Database | ~/.ProFind/ |
| Search Scopes | all, home, selected, hidden |
| Metadata Tags | content, author, comment, creator, title, subject |
ProFind macOS File Search Advanced Features
- Regex-based filename searching for complex naming conventions.
- Scriptable Action Hooks (AppleScript or Shell) for executing custom logic on search results.
- URL Scheme integration (profind:search) for triggering searches from external Openclaw Skills implementations.
- Built-in HTTP API via UPnP SOAP protocol (port 54812) for programmatic integration.
- Comprehensive support for hidden files and excluded paths to refine search accuracy.
SKILL.md
Loading
Related Openclaw Skills
Skill Install Guard
A robust security guardrail that enforces a five-step installation and verification workflow for Openclaw Skills.
PansModel Manager
A comprehensive model management utility for adding, deleting, and switching custom AI model configurations within the PanSclaw environment.
World News Aggregator
A comprehensive intelligence assistant that aggregates tech, stock, AI, and policy news from over 50 global sources with zero configuration.
Math Review Generator
An automated engine for creating comprehensive math review materials in HTML format featuring validated SVG visualizations and original practice questions.
Security Audit CN (sec-audit-cn)
A specialized security auditing skill for applications in China, providing OWASP compliance and local regulatory hardening.
Plant Identification and Care Expert
A professional plant identification and care skill providing scientific species recognition and expert maintenance solutions.
Featured*
