file-finder

Find and manage macOS files using Spotlight, xattr, ditto, and Quick Look.

Updated Aug 27, 2026

Search Tags:#macos #finder #spotlight #ditto #mdfind #xattr #quicklook

Ready to run

npx skills add https://github.com/igot-ai/os-twin --skill file-finder

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: file-finder
Source: https://github.com/igot-ai/os-twin/tree/main/.agents/skills/roles/macos-automation-engineer/file-finder
Command: npx skills add https://github.com/igot-ai/os-twin --skill file-finder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS users often need to locate, preview, and manage files across multiple tools, which creates friction and slows workflows.

Core Features & Use Cases

Spotlight search using mdfind to locate files quickly.
View and manage extended attributes with xattr, and copy with metadata using ditto.
Preview files with Quick Look and reveal items in Finder for quick navigation.
Automate workflows via ostwin commands or daemon dispatch to streamline file operations.

Quick Start

Search for a file using Spotlight, preview it with Quick Look, and copy it while preserving metadata.

Frequently Asked Questions about file-finder

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

FAQPage Schema

How do I search for files on macOS using Spotlight from the command line?▼

You can search for files on macOS using Spotlight by utilizing the mdfind command, which queries the Spotlight index to quickly locate files based on metadata and content across local volumes.

How do I copy files on macOS while preserving extended attributes and metadata?▼

To copy files while preserving extended attributes and metadata on macOS, use the ditto command. It ensures that resource forks and extended file attributes are maintained during the duplication process.

Can I preview files and reveal them in Finder using terminal commands?▼

Yes, you can preview files using the qlmanage Quick Look command and reveal located items in Finder for quick navigation, bridging terminal file discovery with the graphical interface.

How do I view and manage extended attributes on macOS files?▼

You can view and manage extended attributes on macOS files using the xattr command, which displays, sets, and removes metadata properties associated with files stored on local volumes.

What is the best way to orchestrate macOS file discovery and management workflows?▼

The best way to orchestrate macOS file workflows is by integrating mdfind, xattr, and ditto commands with ostwin CLI or daemon dispatch, automating file discovery, inspection, and copying operations.

Does this file management approach work across all local volumes?▼

Yes, this approach works across local volumes by querying the macOS Spotlight index with mdfind and navigating via Finder, ensuring comprehensive file discovery and management on your system.