Finder+

A macOS Electron app that overlays Finder with a smarter file browser and Claude-powered natural language search.

"Find my tax documents from last year" → Done.

---

Quickstart (for development with Claude Code)

# 1. Clone or open this project in Claude Code

# 2. First session: use the initializer prompt
cat INITIALIZER_PROMPT.md
# Paste the contents into Claude Code as your first prompt

# 3. All subsequent sessions: use the coding agent prompt  
cat CODING_AGENT_PROMPT.md
# Paste the contents into Claude Code at the start of each new session

Manual development

npm install
npm run dev

Project structure

finder-plus/
├── CLAUDE.md               # Auto-read by Claude Code — project context
├── INITIALIZER_PROMPT.md   # First-session prompt for Claude Code
├── CODING_AGENT_PROMPT.md  # Subsequent-session prompt for Claude Code
├── feature_list.json       # All 35 features with pass/fail status
├── claude-progress.txt     # Session-by-session progress log
├── init.sh                 # Dev startup + smoke test
├── src/
│   ├── main/               # Electron main process
│   └── renderer/           # React frontend
└── package.json

Features

• 📁 Indexes ~/Downloads, ~/Desktop, ~/Documents automatically
• 🔍 Real-time filter by filename or tag
• ✦ Natural language AI search powered by Claude
• 📌 Pin important files
• 🏷️ Tag files with custom labels
• ⌨️ Global hotkey (Cmd+Shift+Space) to toggle overlay
• 🌫️ Native macOS vibrancy window

Requirements

• macOS 12+
• Node.js 18+
• An Anthropic API key (enter in Preferences)