Navigation scripts help you quickly jump to frequently-used locations, whether they’re files, folders, websites, or applications. These scripts eliminate the need to browse through Finder or bookmarks.
Available Navigation Scripts
File & Folder Navigation Quickly open common directories:
Home folder
Downloads
Documents
Desktop
Applications
Development projects
Custom locations
Website Bookmarks Open frequently-visited websites:
Development tools
Admin panels
Documentation sites
Cloud services
Social media
Application Launchers Launch apps with specific configurations:
Open app in specific workspace
Launch with command-line flags
Open app with specific files
Recent Items Access recent files and locations:
Recently opened files
Recently visited folders
Recently used apps
Common Use Cases
#!/bin/bash # @raycast.schemaVersion 1 # @raycast.title Open Project Directory # @raycast.mode silent # @raycast.icon 💻 open ~/Development/current-project
Quick access to:
Project directories
Git repositories
Configuration files
Log directories
#!/bin/bash # @raycast.schemaVersion 1 # @raycast.title Open Admin Dashboard # @raycast.mode silent # @raycast.icon 🌐 open "https://admin.example.com/dashboard"
Bookmarks for:
Admin panels
Analytics dashboards
Cloud consoles (AWS, GCP, Azure)
Development tools
Open specific Finder locations with custom views: #!/bin/bash # @raycast.schemaVersion 1 # @raycast.title Downloads Folder # @raycast.mode silent # @raycast.icon 📥 open ~/Downloads
#!/bin/bash # @raycast.schemaVersion 1 # @raycast.title Connect to Server # @raycast.mode silent # @raycast.icon 🖥️ open "smb://server.local/share"
Quick access to:
Network drives
SMB shares
FTP servers
Cloud storage
Creating Navigation Scripts
Identify Your Frequent Destinations
Make a list of files, folders, and websites you access multiple times daily.
Create Simple Scripts
Most navigation scripts are just one line: or open "https://example.com"
Add Descriptive Metadata
Use clear titles and appropriate icons: # @raycast.title Open Downloads # @raycast.icon 📥
Organize by Package
Group related navigation scripts: # @raycast.packageName Work Projects
or # @raycast.packageName Web Bookmarks
Advanced Navigation Context-Aware Navigation Open different locations based on time or conditions:
#!/bin/bash # @raycast.schemaVersion 1 # @raycast.title Open Work Folder # @raycast.mode silent hour = $( date +%H ) if [ $hour -ge 9 ] && [ $hour -lt 17 ]; then open ~/Work/current-sprint else open ~/Personal/projects fi
Navigation with Arguments Create parameterized navigation:
#!/bin/bash # @raycast.schemaVersion 1 # @raycast.title Open GitHub Repo # @raycast.mode silent # @raycast.argument1 { "type": "text", "placeholder": "username/repo" } open "https://github.com/ $1 "
Tips Combine navigation scripts with packageName to create organized bookmark categories like “Development”, “Work Sites”, or “Personal”.
Use the silent mode for navigation scripts - they execute instantly without showing output.
For network locations that require authentication, consider security implications before storing credentials in scripts.
System Utilities System navigation and file management
Browsing Web browsing utilities and shortcuts
Apps Application integrations and controls
