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.
SwitchShuttle provides a modern, intuitive interface with several key components:
{
"name": "🚀 Start Development Server",
"command": "npm run dev",
"hotkey": "Ctrl+Shift+D",
"icon": "🚀",
"background": false,
"inputs": {
"port": "3000",
"host": "localhost"
}
}
SwitchShuttle includes pre-built templates for common development workflows:
SwitchShuttle includes a comprehensive Security Manager that protects your system from potentially harmful commands and provides fine-grained control over command execution.
# 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"
],
"background": true,
"hotkey": "Ctrl+Shift+F"
}
Schedule commands to run automatically using cron expressions:
{
"name": "🔄 Auto Backup",
"commands": [
"rsync -av /source/ /backup/"
],
"scheduler": "0 2 * * *",
"background": true,
"hotkey": "Ctrl+Shift+B"
}
Cron Expression Format:
The scheduler uses standard cron expressions with 6 fields: second minute hour day month weekday
Common Cron Examples:
"0 0 * * * *" - Every hour at minute 0"0 0 2 * * *" - Every day at 2:00 AM"0 30 9 * * 1-5" - Weekdays at 9:30 AM"0 0 12 * * 1" - Every Monday at noon"0 0 0 1 * *" - First day of every month"0 */15 * * * *" - Every 15 minutes"0 0 0 * * 0" - Every Sunday at midnightScheduler Features:
Control how commands are executed - in background using ConsolePool or normal terminal execution:
{
"name": "🚀 Start Server",
"commands": [
"npm run dev"
],
"background": true,
"hotkey": "Ctrl+Shift+S"
}
Background Execution Options:
"background": true - Execute using ConsolePool (background)"background": false - Execute using normal terminal execution"background": null or omit - Auto-detect based on command typeOrganize 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 |
commands |
Array | ❌ | Multiple commands to execute |
submenu |
Array | ❌ | Nested subcommands |
switch |
String | ❌ | Command to check switch state (returns true/false) |
monitor |
String | ❌ | Command to get display value for monitoring |
inputs |
Object | ❌ | Dynamic input fields |
hotkey |
String | ❌ | Global hotkey shortcut |
icon |
String | ❌ | Emoji icon for visual identification |
background |
Boolean | ❌ | Execute in background (ConsolePool) or normal terminal |
scheduler |
String | ❌ | Cron expression for scheduled execution |
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
pnpm install
# Development mode
pnpm run tauri dev
# Build for production
pnpm 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
# Install Rust and Node.js
# Then follow the build steps above
# Install system dependencies
sudo apt-get update
sudo apt-get install libwebkit2gtk-4.0-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev
# Then follow the build steps above
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)# Install dependencies
pnpm install
# Start development server
pnpm run tauri dev
# Run type checking
pnpm run type-check
# Build for production
pnpm run tauri build
This project is licensed under the MIT License - see the LICENSE file for details.