macbot-cli 0.1.0__py3-none-any.whl

macbot/__init__.py

@@ -0,0 +1,3 @@
+"""macbot - macOS automation CLI for AI agents and developers."""
+
+__version__ = "0.1.0"

macbot/cli.py

@@ -0,0 +1,48 @@
+"""Main CLI entry point for macbot."""
+
+import click
+
+from . import __version__
+from .context import Context
+from .commands import (
+    apps,
+    audio,
+    bluetooth,
+    brightness,
+    clipboard,
+    notify,
+    screenshot,
+    say,
+    wifi,
+    window,
+)
+
+
+@click.group()
+@click.option("--json", "json_output", is_flag=True, help="Output in JSON format")
+@click.version_option(version=__version__, prog_name="macbot")
+@click.pass_context
+def main(ctx, json_output: bool):
+    """macOS automation CLI for AI agents and developers.
+
+    Control notifications, clipboard, windows, audio, display, and more
+    from the command line with optional JSON output for automation.
+    """
+    ctx.obj = Context(json_output=json_output)
+
+
+# Register command groups
+main.add_command(notify.notify)
+main.add_command(clipboard.clipboard)
+main.add_command(window.window)
+main.add_command(say.say)
+main.add_command(screenshot.screenshot)
+main.add_command(apps.apps)
+main.add_command(audio.audio)
+main.add_command(brightness.brightness)
+main.add_command(wifi.wifi)
+main.add_command(bluetooth.bluetooth)
+
+
+if __name__ == "__main__":
+    main()

macbot/commands/__init__.py

@@ -0,0 +1 @@
+"""macbot commands."""

macbot/commands/apps.py

@@ -0,0 +1,187 @@
+"""Application management commands."""
+
+import subprocess
+import json as json_module
+
+import click
+
+from ..context import pass_context
+
+
+@click.group()
+def apps():
+    """Application list/launch/quit operations."""
+    pass
+
+
+@apps.command("list")
+@click.option("--running", "-r", is_flag=True, help="Only show running apps")
+@pass_context
+def apps_list(ctx, running: bool):
+    """List applications.
+
+    Example:
+        macbot apps list
+        macbot apps list --running
+    """
+    if running:
+        script = '''
+        set appList to {}
+        tell application "System Events"
+            set allProcesses to every process whose background only is false
+            repeat with proc in allProcesses
+                set end of appList to name of proc
+            end repeat
+        end tell
+        set AppleScript's text item delimiters to ":::"
+        return appList as text
+        '''
+        try:
+            result = subprocess.run(
+                ["osascript", "-e", script],
+                capture_output=True,
+                text=True,
+                check=True,
+            )
+            apps_raw = result.stdout.strip().split(":::")
+            apps_list = [{"name": app, "running": True} for app in apps_raw if app.strip()]
+            ctx.output({"apps": apps_list, "count": len(apps_list)})
+        except subprocess.CalledProcessError as e:
+            ctx.error(f"Failed to list apps: {e.stderr}")
+    else:
+        # List installed applications
+        try:
+            result = subprocess.run(
+                ["mdfind", "kMDItemContentType == 'com.apple.application-bundle'"],
+                capture_output=True,
+                text=True,
+                check=True,
+            )
+            apps_list = []
+            for path in result.stdout.strip().split("\n"):
+                if path.strip():
+                    name = path.split("/")[-1].replace(".app", "")
+                    apps_list.append({"name": name, "path": path})
+
+            # Sort by name
+            apps_list.sort(key=lambda x: x["name"].lower())
+            ctx.output({"apps": apps_list, "count": len(apps_list)})
+        except subprocess.CalledProcessError as e:
+            ctx.error(f"Failed to list apps: {e.stderr}")
+
+
+@apps.command("launch")
+@click.argument("app_name")
+@click.option("--background", "-b", is_flag=True, help="Launch in background")
+@pass_context
+def apps_launch(ctx, app_name: str, background: bool):
+    """Launch an application.
+
+    Example:
+        macbot apps launch Safari
+        macbot apps launch "Visual Studio Code" --background
+    """
+    cmd = ["open", "-a", app_name]
+    if background:
+        cmd.append("-g")
+
+    try:
+        subprocess.run(cmd, check=True, capture_output=True, text=True)
+        ctx.output({"app": app_name, "launched": True, "background": background})
+    except subprocess.CalledProcessError as e:
+        ctx.error(f"Failed to launch app: {e.stderr}")
+
+
+@apps.command("quit")
+@click.argument("app_name")
+@click.option("--force", "-f", is_flag=True, help="Force quit")
+@pass_context
+def apps_quit(ctx, app_name: str, force: bool):
+    """Quit an application.
+
+    Example:
+        macbot apps quit Safari
+        macbot apps quit "Frozen App" --force
+    """
+    if force:
+        try:
+            subprocess.run(
+                ["pkill", "-9", "-f", app_name],
+                check=True,
+                capture_output=True,
+                text=True,
+            )
+            ctx.output({"app": app_name, "quit": True, "force": True})
+        except subprocess.CalledProcessError:
+            ctx.error(f"App not running or failed to force quit: {app_name}")
+    else:
+        script = f'''
+        tell application "{app_name}"
+            quit
+        end tell
+        '''
+        try:
+            subprocess.run(
+                ["osascript", "-e", script],
+                check=True,
+                capture_output=True,
+                text=True,
+            )
+            ctx.output({"app": app_name, "quit": True, "force": False})
+        except subprocess.CalledProcessError as e:
+            ctx.error(f"Failed to quit app: {e.stderr}")
+
+
+@apps.command("hide")
+@click.argument("app_name")
+@pass_context
+def apps_hide(ctx, app_name: str):
+    """Hide an application.
+
+    Example:
+        macbot apps hide Safari
+    """
+    script = f'''
+    tell application "System Events"
+        set visible of process "{app_name}" to false
+    end tell
+    '''
+    try:
+        subprocess.run(
+            ["osascript", "-e", script],
+            check=True,
+            capture_output=True,
+            text=True,
+        )
+        ctx.output({"app": app_name, "hidden": True})
+    except subprocess.CalledProcessError as e:
+        ctx.error(f"Failed to hide app: {e.stderr}")
+
+
+@apps.command("show")
+@click.argument("app_name")
+@pass_context
+def apps_show(ctx, app_name: str):
+    """Show/unhide an application.
+
+    Example:
+        macbot apps show Safari
+    """
+    script = f'''
+    tell application "System Events"
+        set visible of process "{app_name}" to true
+    end tell
+    tell application "{app_name}"
+        activate
+    end tell
+    '''
+    try:
+        subprocess.run(
+            ["osascript", "-e", script],
+            check=True,
+            capture_output=True,
+            text=True,
+        )
+        ctx.output({"app": app_name, "shown": True})
+    except subprocess.CalledProcessError as e:
+        ctx.error(f"Failed to show app: {e.stderr}")

macbot/commands/audio.py

@@ -0,0 +1,252 @@
+"""Audio/volume control commands."""
+
+import subprocess
+import re
+
+import click
+
+from ..context import pass_context
+
+
+@click.group()
+def audio():
+    """Volume and audio device control."""
+    pass
+
+
+@audio.command("volume")
+@click.argument("level", required=False, type=int)
+@pass_context
+def audio_volume(ctx, level: int | None):
+    """Get or set system volume (0-100).
+
+    Example:
+        macbot audio volume        # Get current volume
+        macbot audio volume 50     # Set to 50%
+    """
+    if level is not None:
+        # Set volume
+        if level < 0 or level > 100:
+            ctx.error("Volume must be between 0 and 100")
+
+        # macOS volume is 0-7 in AppleScript, convert from 0-100
+        as_volume = int(level * 7 / 100)
+        script = f'set volume output volume {level}'
+
+        try:
+            subprocess.run(
+                ["osascript", "-e", script],
+                check=True,
+                capture_output=True,
+                text=True,
+            )
+            ctx.output({"volume": level, "set": True})
+        except subprocess.CalledProcessError as e:
+            ctx.error(f"Failed to set volume: {e.stderr}")
+    else:
+        # Get volume
+        script = 'output volume of (get volume settings)'
+        try:
+            result = subprocess.run(
+                ["osascript", "-e", script],
+                capture_output=True,
+                text=True,
+                check=True,
+            )
+            volume = int(result.stdout.strip())
+            ctx.output({"volume": volume})
+        except subprocess.CalledProcessError as e:
+            ctx.error(f"Failed to get volume: {e.stderr}")
+
+
+@audio.command("mute")
+@click.option("--toggle", "-t", is_flag=True, help="Toggle mute state")
+@pass_context
+def audio_mute(ctx, toggle: bool):
+    """Mute system audio.
+
+    Example:
+        macbot audio mute
+        macbot audio mute --toggle
+    """
+    if toggle:
+        script = '''
+        set currentMute to output muted of (get volume settings)
+        set volume output muted (not currentMute)
+        return not currentMute
+        '''
+    else:
+        script = '''
+        set volume output muted true
+        return true
+        '''
+
+    try:
+        result = subprocess.run(
+            ["osascript", "-e", script],
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+        muted = result.stdout.strip().lower() == "true"
+        ctx.output({"muted": muted})
+    except subprocess.CalledProcessError as e:
+        ctx.error(f"Failed to mute: {e.stderr}")
+
+
+@audio.command("unmute")
+@pass_context
+def audio_unmute(ctx):
+    """Unmute system audio.
+
+    Example:
+        macbot audio unmute
+    """
+    script = 'set volume output muted false'
+    try:
+        subprocess.run(
+            ["osascript", "-e", script],
+            check=True,
+            capture_output=True,
+            text=True,
+        )
+        ctx.output({"muted": False})
+    except subprocess.CalledProcessError as e:
+        ctx.error(f"Failed to unmute: {e.stderr}")
+
+
+@audio.command("devices")
+@pass_context
+def audio_devices(ctx):
+    """List audio devices.
+
+    Example:
+        macbot audio devices
+    """
+    # Check if SwitchAudioSource is available
+    try:
+        result = subprocess.run(
+            ["which", "SwitchAudioSource"],
+            capture_output=True,
+            text=True,
+        )
+        if result.returncode != 0:
+            ctx.error("SwitchAudioSource not installed. Run: brew install switchaudio-osx")
+
+        # Get output devices
+        output_result = subprocess.run(
+            ["SwitchAudioSource", "-a", "-t", "output"],
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+        output_devices = [d.strip() for d in output_result.stdout.strip().split("\n") if d.strip()]
+
+        # Get input devices
+        input_result = subprocess.run(
+            ["SwitchAudioSource", "-a", "-t", "input"],
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+        input_devices = [d.strip() for d in input_result.stdout.strip().split("\n") if d.strip()]
+
+        # Get current devices
+        current_output = subprocess.run(
+            ["SwitchAudioSource", "-c", "-t", "output"],
+            capture_output=True,
+            text=True,
+        ).stdout.strip()
+
+        current_input = subprocess.run(
+            ["SwitchAudioSource", "-c", "-t", "input"],
+            capture_output=True,
+            text=True,
+        ).stdout.strip()
+
+        ctx.output({
+            "output_devices": output_devices,
+            "input_devices": input_devices,
+            "current_output": current_output,
+            "current_input": current_input,
+        })
+    except subprocess.CalledProcessError as e:
+        ctx.error(f"Failed to list devices: {e.stderr}")
+
+
+@audio.command("output")
+@click.argument("device", required=False)
+@pass_context
+def audio_output(ctx, device: str | None):
+    """Get or set audio output device.
+
+    Example:
+        macbot audio output                    # Get current
+        macbot audio output "MacBook Pro Speakers"  # Set device
+    """
+    try:
+        subprocess.run(["which", "SwitchAudioSource"], check=True, capture_output=True)
+    except subprocess.CalledProcessError:
+        ctx.error("SwitchAudioSource not installed. Run: brew install switchaudio-osx")
+
+    if device:
+        try:
+            subprocess.run(
+                ["SwitchAudioSource", "-s", device, "-t", "output"],
+                check=True,
+                capture_output=True,
+                text=True,
+            )
+            ctx.output({"output_device": device, "set": True})
+        except subprocess.CalledProcessError as e:
+            ctx.error(f"Failed to set output device: {e.stderr}")
+    else:
+        try:
+            result = subprocess.run(
+                ["SwitchAudioSource", "-c", "-t", "output"],
+                capture_output=True,
+                text=True,
+                check=True,
+            )
+            ctx.output({"output_device": result.stdout.strip()})
+        except subprocess.CalledProcessError as e:
+            ctx.error(f"Failed to get output device: {e.stderr}")
+
+
+@audio.command("input")
+@click.argument("device", required=False)
+@pass_context
+def audio_input(ctx, device: str | None):
+    """Get or set audio input device.
+
+    Example:
+        macbot audio input                        # Get current
+        macbot audio input "MacBook Pro Microphone"  # Set device
+    """
+    try:
+        subprocess.run(["which", "SwitchAudioSource"], check=True, capture_output=True)
+    except subprocess.CalledProcessError:
+        ctx.error("SwitchAudioSource not installed. Run: brew install switchaudio-osx")
+
+    if device:
+        try:
+            subprocess.run(
+                ["SwitchAudioSource", "-s", device, "-t", "input"],
+                check=True,
+                capture_output=True,
+                text=True,
+            )
+            ctx.output({"input_device": device, "set": True})
+        except subprocess.CalledProcessError as e:
+            ctx.error(f"Failed to set input device: {e.stderr}")
+    else:
+        try:
+            result = subprocess.run(
+                ["SwitchAudioSource", "-c", "-t", "input"],
+                capture_output=True,
+                text=True,
+                check=True,
+            )
+            ctx.output({"input_device": result.stdout.strip()})
+        except subprocess.CalledProcessError as e:
+            ctx.error(f"Failed to get input device: {e.stderr}")