mac-finder — Open Finder at a Directory

SkillFiles & storage

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.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the mac-finder skill

What this skill tells your AI

The instructions your AI receives, as published by leionion/clawforge in skills/05-Interaction/mac_finder/SKILL.md and read by ahel’s review.

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

NamePath
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

Signals

GitHub stars
91
Forks
21
Last commit
May 2026
Advanced
Item type
skill
Key
mac-finder
Source
github.com/leionion/clawforge