OwlScopeDocs

Script Runner

Run scripts without opening Terminal

Overview

Assign shell scripts or terminal commands to any menu slot. When executed, the script runs in the background — no Terminal window pops up, no context switching.

How to Set Up

  1. Open Settings → Menu.
  2. Click an empty slot or edit an existing one.
  3. Choose Script as the action type.
  4. Select a script file or enter a script path.
  5. Optionally add arguments and choose a custom interpreter.

Supported Scripts

  • Shell scripts (bash, zsh, sh)
  • Python scripts (.py)
  • Ruby scripts (.rb)
  • AppleScript files (.scpt, .applescript)
  • Script files on disk (e.g., ~/scripts/deploy.sh)
  • Scripts with arguments and a custom interpreter
Note: Scripts run in their own directory. When the script completes successfully, a macOS notification confirms execution.

Use Cases

  • Git shortcuts — git pull origin main, git stash
  • Deployment — ./deploy.sh staging
  • Homebrew — brew update && brew upgrade
  • Quick lookups — curl wttr.in/Hanoi?format=3 (weather → clipboard)
  • Docker — docker compose up -d