Your Finder-native AI companion for macOS.
๐บ Watch the Demo Video
Nest is a native macOS AI agent that lives directly inside Finder.
Instead of copying and pasting files into a web browser, just select files right in Finder, tell Nest what you want, and let it work. Whether you need to inspect code, transform documents, organize chaotic folders, or act on media, Nest understands your current selection using natural language.
It docks elegantly beneath the active Finder window, speaks to your chosen AI provider, and translates your requests into safe, useful local file actions.
- ๐ฏ Finder-Native Experience: Docks perfectly with your active window. No context switching.
- ๐ฃ๏ธ Natural Language Commands: Talk to your files in plain English.
- ๐ Bring Your Own AI: Plug in your API keys. Supports Gemini, OpenRouter, OpenAI-compatible APIs, and even Ollama for 100% offline local privacy.
- โก Instant Shortcuts: Pre-built instant actions for common, repetitive file operations.
- ๐ก๏ธ Safe by Design: Harmless commands run automatically. Risky or destructive commands are presented as a preview for your explicit approval.
- ๐ Live Progress: Real-time in-bar progress and result display.
- ๐ Activity Log: Keep track of recent prompts, generated commands, and terminal outputs.
- ๐ ๏ธ Extensible: Supports optional CLI tools like
ImageMagick,FFmpeg,Pandoc, andPopplerfor advanced transformations.
Looking for ideas? Here are some example commands to try directly from Finder:
For quick conversions you can just type a format name (e.g., โmp4โ, โwavโ). Some advanced operations use optional extra tools that Nest can install automatically via Homebrew (with your confirmation).
Convert to mp4mp4Convert to mp4, 1080p, 30fps, 1000kbit/sMake animated gif from this mp4, 600 pixels wide, 12fpswhat bitrate is this video?Trim this 16:9 video to be 16:10
Short prompts work: say just the target format (e.g., โjpgโ, โpngโ). Some image operations can use optional tools like ImageMagick, installed via Homebrew on request.
Make a jpgjpgRotate this image right by 90 degreesBatch resize all images in this folder to 1024 pixels wideresize this to 1080 px tallis this file with a .jpg extension actually a PNG?Make a 3x3 grid of images out of thesePut a 10px border around this imageCrop this image by 50 pixels on each sideOverlay this image with "Nest" in bold white letters
Nest answers maths questions using the builtโin bc calculator on your Mac. We translate your prompt into an exact expression and evaluate it locally with high precisionโso you get deterministic results without any AI โbest guessesโ.
5 foot 9 in cm?1 day in seconds?15% of $85.99?Convert 42 USD to EURWhat's the square root of 1764?
Create and inspect archives.
Zip these upzipWhat files are inside this zip?put in screenshots folder, zip em up!
Quick text utilities and editing.
open in Text MateMake a new readme.txtword count?
Sort and tidy folders in just a few words.
tidy up this folderorganize by date
Convert between document formats. Nest can use Pandoc for bestโinโclass conversions, and can install it automatically via Homebrew (with your confirmation).
Convert this docx to htmlConvert this DOCX to MarkdownConvert this Markdown to HTMLConvert this DOCX to EPUB
Advanced PDF tools use optional extra utilities such as QPDF, Ghostscript and Poppler that Nest can install automatically via Homebrew (with confirmation).
author of this pdf?Optimise this PDFExtract the text from this PDFSave just page 2 of this PDF to a separate fileRotate page 2 of this PDF by 90 degrees clockwiseMerge these PDFsRemove password from this PDFAdd a password to this PDFSplit this PDF into separate pages
Inspect file types, sources and permissions.
What type of file is this?Where did I download this file from?Why is this file greyed out in Finder?
Download this file here: <url>
total lines of JavaScript?Commit and push everythingswitch to dev branch
Print this outKeep my Mac awake for the next hourToggle dark modeMake invisible files visibleWhat processor does this Mac have?How much RAM do I have?
What's the weather in Tokyo?
pwdSend this using the Messages app to "friend@example.com"
Grab the latest .dmg from the GitHub Releases page:
๐ Download Nest Now
- Open the
.dmgand drag Nest into yourApplicationsfolder. - Launch Nest. (If macOS warns about an unidentified developer, right-click Nest and select Open).
Nest acts as your hands and eyes in the file system. It requires macOS Accessibility and Automation permissions to follow Finder windows and understand selected files. macOS will prompt you for these on the first run.
Nest is completely BYOK (Bring Your Key). API keys are stored securely and locally on your machine at:
~/.finder_ai_config.jsonNest can leverage powerful open-source tools if you have them installed. It will never install them automatically without your permission.
- ImageMagick: For advanced image manipulation.
- FFmpeg/FFprobe: For video/audio conversion and inspection.
- Pandoc: For document conversion (Markdown, Word, PDF).
- Poppler / QPDF: For advanced PDF wizardry.
Built with Swift, AppKit, and SwiftUI.
Designed for builders who live in Finder.




