ScriptRunner

A lightweight macOS menu bar application for running and managing shell scripts with real-time output monitoring.

Features

• Run shell commands directly from the macOS menu bar
• Real-time output display with ANSI color support
• Process management (start, stop, restart, remove)
• Recent commands history
• Detached process recovery (survives app restarts)
• Multiple script execution with individual output windows

Installation

Build from Source

1. Clone this repository

2. Build the application:

   swiftc -o ScriptRunner ScriptRunner.swift

3. Create the app bundle structure and copy the executable:

   # The ScriptRunner.app bundle is already included in the repository
   # Just rebuild the executable if needed
   swiftc -o ScriptRunner.app/Contents/MacOS/ScriptRunner ScriptRunner.swift

4. Move ScriptRunner.app to your Applications folder or run it directly

Usage

1. Launch ScriptRunner - it appears in your menu bar with a terminal icon
2. Click the menu bar icon to access options
3. Select "Start Script" to run a new command
4. Enter your command (e.g., python3 ~/scripts/main.py)
5. Monitor output in the dedicated output window

Menu Options

• Start Script: Launch a new script with a custom command
• Running Scripts: View and manage currently running scripts
  • Show Output: Display the output window
  • Stop: Terminate the running process
  • Restart: Stop and relaunch the script
  • Remove: Remove from the list (only for stopped scripts)
• Recent Scripts: Quick access to previously run commands
• Detached Scripts: Manage processes that survived app restarts

Script States

• ● Running: Script is currently executing
• ○ Exited: Script has finished
• ⚠ Detached: Process survived app restart

Features in Detail

ANSI Color Support

Output windows support ANSI color codes, making colorized terminal output readable and properly formatted.

Process Persistence

ScriptRunner tracks running processes and can recover them after the app restarts, allowing you to manage long-running scripts even if the app crashes or is relaunched.

Recent Commands

The last 10 commands are saved for quick re-execution, making it easy to run frequently used scripts.

Requirements

• macOS 11.0 or later
• Xcode Command Line Tools (for building from source)

License

This project is open source and available for personal and commercial use.