Mac Finder

Opens macOS Finder at a specified directory path, with tilde expansion and common-directory shortcuts. Use when the user asks to open a folder, navigate to a directory, browse files, show a path in Finder, or open Downloads/Desktop/Documents on macOS.

leionion Updated

File contents

mac-finder — Open Finder at a Directory

Opens Finder and navigates to a specified directory path. Supports ~ expansion and validates that the path exists before opening.

Usage

# Open a specific directory in Finder
python3 mac_finder.py "~/Downloads"
python3 mac_finder.py "/Users/benson/Desktop"
python3 mac_finder.py "/Applications"

Common directories

Name Path
Desktop ~/Desktop
Downloads ~/Downloads
Documents ~/Documents
Pictures ~/Pictures
Music ~/Music
Movies ~/Movies
Applications /Applications

How it works

  • Expands ~ to the user's home directory via os.path.expanduser
  • Validates that the path exists and is a directory
  • Opens the directory with open and activates Finder via osascript

leionion/ClawForge/tree/main/skills/05-Interaction/mac_finder commit 2496efcfae

Frequently asked questions

npx skillmds@latest add leionion/mac-finder