SwitchShuttle is a powerful cross-platform system tray application that revolutionizes how you manage and execute terminal commands. Built with modern technologies (Rust + Tauri + Vue.js), it provides a sleek interface for organizing, customizing, and quickly accessing your most-used terminal operations.
# Install via Homebrew
brew tap s00d/switchshuttle
brew install --cask switchshuttle
SwitchShuttle also provides a powerful command-line interface for quick command execution without opening the GUI.
# Execute by command ID
switch-shuttle cmd_8
# Execute by command name (case-insensitive)
switch-shuttle "Example Command"
# Show all available commands with their IDs
switch-shuttle --list
# or
switch-shuttle -l
# Search for commands containing specific text
switch-shuttle --search "git"
# or
switch-shuttle -s "docker"
# If installed via Homebrew
switch-shuttle --list
# If installed manually
/Applications/switch-shuttle.app/Contents/MacOS/SwitchShuttle --list
# Create an alias for easier access
echo 'alias switch-shuttle="/Applications/switch-shuttle.app/Contents/MacOS/SwitchShuttle"' >> ~/.zshrc
source ~/.zshrc
# If installed via installer
"C:\Program Files\SwitchShuttle\switch-shuttle.exe" --list
# If installed via winget or chocolatey
switch-shuttle --list
# Add to PATH for easier access
# Add "C:\Program Files\SwitchShuttle" to your system PATH
# If installed via package manager
switch-shuttle --list
# If installed manually
./switch-shuttle --list
# Make executable and add to PATH
chmod +x switch-shuttle
sudo mv switch-shuttle /usr/local/bin/
# Quick git operations
switch-shuttle "git status"
switch-shuttle "git pull"
# Development workflows
switch-shuttle "npm run dev"
switch-shuttle "docker-compose up"
# List all available commands
switch-shuttle --list
# Find commands related to database
switch-shuttle --search "database"
SwitchShuttle uses JSON configuration files stored in:
~/.config/switch-shuttle/
C:\Users\<Username>\AppData\Roaming\switch-shuttle\
{
"terminal": "iterm",
"launch_in": "new_tab",
"title": "My Commands",
"commands": [
{
"name": "🚀 Start Development Server",
"command": "npm run dev",
"hotkey": "Ctrl+Shift+D"
},
{
"name": "📦 Install Dependencies",
"command": "npm install",
"hotkey": "Ctrl+Shift+I"
},
{
"name": "🔧 Development Tools",
"submenu": [
{
"name": "🧪 Run Tests",
"command": "npm test",
"hotkey": "Ctrl+Shift+T"
},
{
"name": "📊 Build Project",
"command": "npm run build",
"hotkey": "Ctrl+Shift+B"
}
]
}
]
}
Create interactive commands that prompt for user input:
{
"name": "📝 Create New Component",
"inputs": {
"componentName": "MyComponent",
"componentType": "functional"
},
"commands": [
"mkdir -p src/components/[componentName]",
"touch src/components/[componentName]/index.tsx",
"echo 'import React from \"react\";' > src/components/[componentName]/index.tsx",
"echo 'export const [componentName] = () => <div>[componentName]</div>;' >> src/components/[componentName]/index.tsx"
],
"hotkey": "Ctrl+Shift+N"
}
Execute a sequence of commands:
{
"name": "🔄 Full Development Cycle",
"commands": [
"git pull origin main",
"npm install",
"npm run lint",
"npm run test",
"npm run build"
],
"hotkey": "Ctrl+Shift+F"
}
Organize commands in hierarchical menus:
{
"name": "🐳 Docker Operations",
"submenu": [
{
"name": "🚀 Start Services",
"submenu": [
{
"name": "🏗️ Development",
"command": "docker-compose -f docker-compose.dev.yml up -d"
},
{
"name": "🏭 Production",
"command": "docker-compose -f docker-compose.prod.yml up -d"
}
]
},
{
"name": "🛑 Stop All",
"command": "docker-compose down"
}
]
}
Toggle system features with background execution:
{
"name": "🔧 System Controls",
"submenu": [
{
"name": "📶 Toggle WiFi",
"command": "networksetup -setairportpower en0 toggle",
"switch": "networksetup -getairportpower en0 | grep -q 'On' && echo 'true' || echo 'false'"
},
{
"name": "🔊 Toggle Bluetooth",
"command": "blueutil -p toggle",
"switch": "blueutil -p | grep -q '1' && echo 'true' || echo 'false'"
},
{
"name": "🌙 Toggle Dark Mode",
"command": "osascript -e 'tell app \"System Events\" to tell appearance preferences to set dark mode to not dark mode'",
"switch": "osascript -e 'tell app \"System Events\" to tell appearance preferences to get dark mode'"
}
]
}
Switch Command Features:
Monitor system resources and services with real-time information:
{
"name": "📊 System Monitoring",
"submenu": [
{
"name": "💾 Memory Usage",
"command": "top -l 1 | head -n 10",
"monitor": "memory",
"icon": "🧠"
},
{
"name": "💻 CPU Load",
"command": "top -l 1 | grep 'CPU usage'",
"monitor": "cpu",
"icon": "⚡"
},
{
"name": "💾 Disk Space",
"command": "df -h | grep '/dev/'",
"monitor": "disk",
"icon": "💾"
},
{
"name": "🌐 Network Status",
"command": "ifconfig | grep -E 'inet |status:'",
"monitor": "network",
"icon": "🌐"
}
]
}
Monitor Command Features:
Parameter | Type | Description | Default |
---|---|---|---|
terminal |
String | Terminal application to use | "terminal" |
launch_in |
String | Where to launch commands | "current" |
theme |
String | Terminal theme (if supported) | - |
title |
String | Window/tab title | - |
menu_hotkey |
String | Global hotkey to open menu | - |
commands |
Array | List of command configurations | [] |
enabled |
Boolean | Whether this configuration should be loaded | true |
Terminal | macOS | Windows | Linux |
---|---|---|---|
iterm |
✅ | ❌ | ❌ |
terminal |
✅ | ✅ | ✅ |
warp |
✅ | ❌ | ❌ |
alacritty |
✅ | ✅ | ✅ |
hyper |
✅ | ✅ | ✅ |
Mode | Description |
---|---|
current |
Execute in current terminal window |
new_tab |
Open new tab and execute |
new_window |
Open new window and execute |
Parameter | Type | Required | Description |
---|---|---|---|
name |
String | ✅ | Display name for the command |
command |
String | ❌ | Single command to execute |
commands |
Array | ❌ | Multiple commands to execute |
submenu |
Array | ❌ | Nested subcommands |
inputs |
Object | ❌ | Dynamic input fields |
hotkey |
String | ❌ | Global hotkey shortcut |
switch |
String | ❌ | Command to check current status (for toggle commands) |
monitor |
String | ❌ | Monitor type for real-time resource tracking |
icon |
String | ❌ | Emoji icon for visual identification |
You can enable or disable individual configuration files to control which commands are available in the system tray menu. This is useful for:
In the Visual Editor:
In JSON Configuration:
{
"terminal": "iterm",
"launch_in": "current",
"title": "My Commands",
"enabled": true,
"commands": [
{
"name": "Example Command",
"command": "echo Hello World"
}
]
}
Parameter | Type | Default | Description |
---|---|---|---|
enabled |
Boolean | true |
Whether this configuration should be loaded and available in the menu |
Note: When enabled
is set to false
or omitted, the configuration will be ignored and its commands won't appear in the system tray menu.
# Clone the repository
git clone https://github.com/s00d/switchshuttle.git
cd switchshuttle
# Install dependencies
npm install
# Development mode
npm run tauri dev
# Build for production
npm run tauri build
# If you encounter signing issues
chmod +x /Applications/switch-shuttle.app
xattr -cr /Applications/switch-shuttle.app
codesign --force --deep --sign - /Applications/switch-shuttle.app
We welcome contributions! Here's how you can help:
git checkout -b feature/amazing-feature
)git commit -m 'Add amazing feature'
)git push origin feature/amazing-feature
)This project is licensed under the MIT License - see the LICENSE file for details.