Sortio + Raycast: Sort Files From Your Launcher
A guide to integrating Sortio with Raycast, the keyboard-driven launcher for macOS, enabling users to trigger AI-powered file sorting directly from the command palette using Script Commands, hotkeys, and Quicklinks. This integration keeps file organization within the launcher-based workflow that power users already rely on.
In This Guide
The Challenge
Power users who live in keyboard-driven launchers like Raycast lose momentum every time they need to switch to a separate application to organize files. The context switch from keyboard-centric workflow to mouse-driven file management breaks flow state and makes file organization feel like a chore rather than a natural part of the workflow.
Who This Guide Is For
- Raycast power users who want file sorting integrated into their launcher
- Developers and designers who prefer keyboard-driven workflows
- Mac users who want to trigger AI file sorting with a single hotkey
- Anyone who wants to sort files without leaving their current context
Step-by-Step Guide
Install Raycast Script Commands
Open Raycast preferences and navigate to the Extensions tab. Ensure Script Commands are enabled and note the designated script directory. Raycast discovers and executes scripts placed in this directory from its command palette.
Create a Sort Downloads Script
Create a sort-downloads.sh file in your Raycast Script Commands directory with the required Raycast metadata comments and a command to open Sortio with your Downloads folder as the target. Make the script executable with chmod +x. Type "Sort Downloads" in Raycast to trigger it.
Create a Sort Current Finder Folder Script
Build a script that uses osascript to grab the frontmost Finder window path and passes it to Sortio. This lets you sort whatever folder you are currently viewing without specifying a path manually.
Assign Hotkeys for Instant Access
In Raycast preferences, find your Sortio commands and bind them to global hotkeys like Ctrl+Shift+S for Sort Downloads and Ctrl+Shift+D for Sort Current Folder. Sorting becomes a reflex triggered by muscle memory.
Set Up Quicklinks and Clipboard Integration
Create Raycast Quicklinks for folders you sort frequently. Build a clipboard-aware script that reads a folder path from the clipboard and triggers Sortio on it, enabling seamless sorting from Terminal or Finder without switching contexts.
Chain Sortio with Other Raycast Extensions
Build compound workflows where sorting is one step in a larger chain. For example, after sorting a project deliverables folder, post a Slack message confirming the files are organized, or create a Todoist task to review the sorted output.
Example Workflow
1Before
A developer has accumulated files across Downloads and Desktop throughout the day: email attachments, browser downloads, screenshots, and exported documents. Opening a separate app to organize them interrupts flow.
2The Prompt
Sort Downloads by type: documents to Documents, installers to Applications/Installers, screenshots to Pictures by content, and project files to the appropriate project folder3After
The developer presses Ctrl+Shift+S without leaving their editor. Raycast triggers Sortio in the background, which analyzes file contents and sorts everything into categorized folders. A notification confirms completion. Total interruption: under one second.
Pro Tips
- Keep Sortio rules well-defined -- vague rules produce vague results when triggered via Raycast without visual feedback
- Sortio's content-aware analysis correctly handles files with generic names like "Document.pdf" even when triggered from Raycast
- Test scripts on small folders first before binding hotkeys to sort large directories
- Use Sortio's offline mode (Ollama) for sensitive directories to ensure no file contents leave your machine
- Create separate Raycast commands for different rule sets: one for work projects, another for personal organization
Frequently Asked Questions
Do I need the Sortio Pro plan to use Raycast integration?
No. Raycast integration works with Sortio's Free tier. The scripts simply launch Sortio with specific folder arguments, and the Free plan handles all core sorting features including content-aware AI analysis, custom natural-language rules, and offline processing via Ollama.
Can I trigger Sortio from Raycast on Windows or Linux?
Raycast is currently macOS-only. However, Sortio itself runs on macOS, Windows, and Linux. On Windows, you can achieve a similar workflow using PowerToys Run with custom plugins. On Linux, tools like Albert or Ulauncher support script-based extensions that can trigger Sortio similarly.
Will Raycast scripts interfere with Sortio's automatic folder watching?
No. Sortio's automatic folder watching and Raycast-triggered manual sorts operate independently. Triggering a Raycast sort on a watched folder simply runs an additional pass. Sortio handles overlapping operations gracefully with no risk of duplicate moves or conflicting actions.
How do I troubleshoot if my Raycast script does not trigger Sortio?
Verify the script is executable with chmod +x. Confirm Sortio is installed by running open -a "Sortio" from Terminal. Check that your Raycast Script Commands directory is correctly configured. Ensure the script has the correct Raycast metadata comments at the top. If Sortio opens but does not sort, review your sorting rules within the Sortio application.
Related Glossary Terms
Ready to Implement This Guide?
Sortio can automate much of this workflow with AI-powered file organization. Let Sortio handle the sorting while you focus on your work.
Download Sortio Free