macbot-cli 0.1.0__py3-none-any.whl

macbot/commands/wifi.py

@@ -0,0 +1,222 @@
+"""WiFi control commands."""
+
+import subprocess
+import re
+
+import click
+
+from ..context import pass_context
+
+# System utilities paths
+NETWORKSETUP = "/usr/sbin/networksetup"
+IPCONFIG = "/usr/sbin/ipconfig"
+AIRPORT = "/System/Library/PrivateFrameworks/Apple80211.framework/Versions/Current/Resources/airport"
+
+
+def get_wifi_interface() -> str:
+    """Get the WiFi interface name (usually en0)."""
+    try:
+        result = subprocess.run(
+            [NETWORKSETUP, "-listallhardwareports"],
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+        lines = result.stdout.split("\n")
+        for i, line in enumerate(lines):
+            if "Wi-Fi" in line or "AirPort" in line:
+                for j in range(i, min(i + 3, len(lines))):
+                    if "Device:" in lines[j]:
+                        return lines[j].split(":")[1].strip()
+    except Exception:
+        pass
+    return "en0"  # Default
+
+
+@click.group()
+def wifi():
+    """WiFi status and control."""
+    pass
+
+
+@wifi.command("status")
+@pass_context
+def wifi_status(ctx):
+    """Get WiFi status and connected network.
+
+    Example:
+        macbot wifi status
+    """
+    interface = get_wifi_interface()
+
+    try:
+        # Get power state
+        power_result = subprocess.run(
+            [NETWORKSETUP, "-getairportpower", interface],
+            capture_output=True,
+            text=True,
+        )
+        power_on = "On" in power_result.stdout
+
+        # Get current network
+        network_result = subprocess.run(
+            [NETWORKSETUP, "-getairportnetwork", interface],
+            capture_output=True,
+            text=True,
+        )
+        network = None
+        if "Current Wi-Fi Network:" in network_result.stdout:
+            network = network_result.stdout.split(":")[1].strip()
+        elif "You are not associated" in network_result.stdout:
+            network = None
+
+        # Get IP address
+        ip_result = subprocess.run(
+            [IPCONFIG, "getifaddr", interface],
+            capture_output=True,
+            text=True,
+        )
+        ip_address = ip_result.stdout.strip() if ip_result.returncode == 0 else None
+
+        ctx.output({
+            "interface": interface,
+            "power": "on" if power_on else "off",
+            "network": network,
+            "ip_address": ip_address,
+            "connected": network is not None,
+        })
+    except subprocess.CalledProcessError as e:
+        ctx.error(f"Failed to get WiFi status: {e.stderr}")
+
+
+@wifi.command("on")
+@pass_context
+def wifi_on(ctx):
+    """Turn WiFi on.
+
+    Example:
+        macbot wifi on
+    """
+    interface = get_wifi_interface()
+    try:
+        subprocess.run(
+            [NETWORKSETUP, "-setairportpower", interface, "on"],
+            check=True,
+            capture_output=True,
+            text=True,
+        )
+        ctx.output({"wifi": "on", "interface": interface})
+    except subprocess.CalledProcessError as e:
+        ctx.error(f"Failed to turn WiFi on: {e.stderr}")
+
+
+@wifi.command("off")
+@pass_context
+def wifi_off(ctx):
+    """Turn WiFi off.
+
+    Example:
+        macbot wifi off
+    """
+    interface = get_wifi_interface()
+    try:
+        subprocess.run(
+            [NETWORKSETUP, "-setairportpower", interface, "off"],
+            check=True,
+            capture_output=True,
+            text=True,
+        )
+        ctx.output({"wifi": "off", "interface": interface})
+    except subprocess.CalledProcessError as e:
+        ctx.error(f"Failed to turn WiFi off: {e.stderr}")
+
+
+@wifi.command("networks")
+@pass_context
+def wifi_networks(ctx):
+    """List available WiFi networks.
+
+    Example:
+        macbot wifi networks
+    """
+    interface = get_wifi_interface()
+
+    try:
+        result = subprocess.run(
+            [AIRPORT, "-s"],
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+
+        networks = []
+        lines = result.stdout.strip().split("\n")
+        if len(lines) > 1:  # Skip header
+            for line in lines[1:]:
+                parts = line.split()
+                if len(parts) >= 2:
+                    # SSID may have spaces, RSSI is usually negative number
+                    # Find the RSSI (negative number)
+                    for i, part in enumerate(parts):
+                        if part.startswith("-") and part[1:].isdigit():
+                            ssid = " ".join(parts[:i])
+                            rssi = int(part)
+                            networks.append({
+                                "ssid": ssid.strip(),
+                                "rssi": rssi,
+                                "signal": "excellent" if rssi > -50 else "good" if rssi > -70 else "fair" if rssi > -80 else "weak"
+                            })
+                            break
+
+        ctx.output({"networks": networks, "count": len(networks)})
+    except subprocess.CalledProcessError as e:
+        ctx.error(f"Failed to scan networks: {e.stderr}")
+    except FileNotFoundError:
+        ctx.error("airport command not found")
+
+
+@wifi.command("connect")
+@click.argument("ssid")
+@click.option("--password", "-p", help="WiFi password")
+@pass_context
+def wifi_connect(ctx, ssid: str, password: str | None):
+    """Connect to a WiFi network.
+
+    Example:
+        macbot wifi connect "MyNetwork" --password "secret123"
+    """
+    interface = get_wifi_interface()
+
+    cmd = [NETWORKSETUP, "-setairportnetwork", interface, ssid]
+    if password:
+        cmd.append(password)
+
+    try:
+        subprocess.run(cmd, check=True, capture_output=True, text=True)
+        ctx.output({"ssid": ssid, "connected": True})
+    except subprocess.CalledProcessError as e:
+        ctx.error(f"Failed to connect: {e.stderr}")
+
+
+@wifi.command("disconnect")
+@pass_context
+def wifi_disconnect(ctx):
+    """Disconnect from current WiFi network.
+
+    Example:
+        macbot wifi disconnect
+    """
+    interface = get_wifi_interface()
+
+    try:
+        subprocess.run(
+            [AIRPORT, "-z"],
+            check=True,
+            capture_output=True,
+            text=True,
+        )
+        ctx.output({"disconnected": True, "interface": interface})
+    except subprocess.CalledProcessError as e:
+        ctx.error(f"Failed to disconnect: {e.stderr}")
+    except FileNotFoundError:
+        ctx.error("airport command not found")

macbot/commands/window.py

@@ -0,0 +1,234 @@
+"""Window management commands."""
+
+import subprocess
+import json as json_module
+
+import click
+
+from ..context import pass_context
+
+
+@click.group()
+def window():
+    """Window list/focus/move operations."""
+    pass
+
+
+@window.command("list")
+@click.option("--app", "-a", help="Filter by application name")
+@pass_context
+def window_list(ctx, app: str | None):
+    """List all windows.
+
+    Example:
+        macbot window list
+        macbot window list --app Safari
+    """
+    script = '''
+    set windowList to {}
+    tell application "System Events"
+        set allProcesses to every process whose visible is true
+        repeat with proc in allProcesses
+            set procName to name of proc
+            try
+                set procWindows to every window of proc
+                repeat with w in procWindows
+                    set windowName to name of w
+                    set windowPos to position of w
+                    set windowSize to size of w
+                    set end of windowList to procName & "|||" & windowName & "|||" & (item 1 of windowPos as text) & "," & (item 2 of windowPos as text) & "|||" & (item 1 of windowSize as text) & "," & (item 2 of windowSize as text)
+                end repeat
+            end try
+        end repeat
+    end tell
+    set AppleScript's text item delimiters to ":::"
+    return windowList as text
+    '''
+
+    try:
+        result = subprocess.run(
+            ["osascript", "-e", script],
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+
+        windows = []
+        if result.stdout.strip():
+            for item in result.stdout.strip().split(":::"):
+                if "|||" in item:
+                    parts = item.split("|||")
+                    if len(parts) >= 4:
+                        pos = parts[2].split(",")
+                        size = parts[3].split(",")
+                        window_info = {
+                            "app": parts[0],
+                            "title": parts[1],
+                            "x": int(pos[0]) if pos[0].strip().lstrip("-").isdigit() else 0,
+                            "y": int(pos[1]) if pos[1].strip().lstrip("-").isdigit() else 0,
+                            "width": int(size[0]) if size[0].strip().isdigit() else 0,
+                            "height": int(size[1]) if size[1].strip().isdigit() else 0,
+                        }
+                        if app is None or app.lower() in window_info["app"].lower():
+                            windows.append(window_info)
+
+        ctx.output({"windows": windows, "count": len(windows)})
+    except subprocess.CalledProcessError as e:
+        ctx.error(f"Failed to list windows: {e.stderr}")
+
+
+@window.command("focus")
+@click.argument("app_name")
+@click.option("--title", "-t", help="Window title to focus (partial match)")
+@pass_context
+def window_focus(ctx, app_name: str, title: str | None):
+    """Focus an application window.
+
+    Example:
+        macbot window focus Safari
+        macbot window focus "Visual Studio Code" --title "project"
+    """
+    if title:
+        script = f'''
+        tell application "System Events"
+            tell process "{app_name}"
+                set frontmost to true
+                repeat with w in windows
+                    if name of w contains "{title}" then
+                        perform action "AXRaise" of w
+                        return "focused"
+                    end if
+                end repeat
+            end tell
+        end tell
+        return "not found"
+        '''
+    else:
+        script = f'''
+        tell application "{app_name}"
+            activate
+        end tell
+        return "focused"
+        '''
+
+    try:
+        result = subprocess.run(
+            ["osascript", "-e", script],
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+        status = result.stdout.strip()
+        if status == "not found":
+            ctx.error(f"Window not found: {title}")
+        ctx.output({"app": app_name, "title": title, "focused": True})
+    except subprocess.CalledProcessError as e:
+        ctx.error(f"Failed to focus window: {e.stderr}")
+
+
+@window.command("move")
+@click.argument("app_name")
+@click.option("--x", type=int, help="X position")
+@click.option("--y", type=int, help="Y position")
+@click.option("--width", "-w", type=int, help="Window width")
+@click.option("--height", "-h", type=int, help="Window height")
+@click.option("--title", "-t", help="Window title (partial match)")
+@pass_context
+def window_move(
+    ctx,
+    app_name: str,
+    x: int | None,
+    y: int | None,
+    width: int | None,
+    height: int | None,
+    title: str | None,
+):
+    """Move/resize an application window.
+
+    Example:
+        macbot window move Safari --x 0 --y 0 --width 1200 --height 800
+    """
+    script_parts = [f'tell application "System Events"', f'tell process "{app_name}"']
+
+    if title:
+        script_parts.append(f'''
+            repeat with w in windows
+                if name of w contains "{title}" then
+                    set targetWindow to w
+                    exit repeat
+                end if
+            end repeat
+        ''')
+        window_ref = "targetWindow"
+    else:
+        window_ref = "front window"
+
+    if x is not None and y is not None:
+        script_parts.append(f"set position of {window_ref} to {{{x}, {y}}}")
+
+    if width is not None and height is not None:
+        script_parts.append(f"set size of {window_ref} to {{{width}, {height}}}")
+
+    script_parts.extend(["end tell", "end tell"])
+    script = "\n".join(script_parts)
+
+    try:
+        subprocess.run(
+            ["osascript", "-e", script],
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+        ctx.output({
+            "app": app_name,
+            "title": title,
+            "x": x,
+            "y": y,
+            "width": width,
+            "height": height,
+            "moved": True,
+        })
+    except subprocess.CalledProcessError as e:
+        ctx.error(f"Failed to move window: {e.stderr}")
+
+
+@window.command("minimize")
+@click.argument("app_name")
+@click.option("--all", "minimize_all", is_flag=True, help="Minimize all windows")
+@pass_context
+def window_minimize(ctx, app_name: str, minimize_all: bool):
+    """Minimize application window(s).
+
+    Example:
+        macbot window minimize Safari
+        macbot window minimize Safari --all
+    """
+    if minimize_all:
+        script = f'''
+        tell application "System Events"
+            tell process "{app_name}"
+                repeat with w in windows
+                    set value of attribute "AXMinimized" of w to true
+                end repeat
+            end tell
+        end tell
+        '''
+    else:
+        script = f'''
+        tell application "System Events"
+            tell process "{app_name}"
+                set value of attribute "AXMinimized" of front window to true
+            end tell
+        end tell
+        '''
+
+    try:
+        subprocess.run(
+            ["osascript", "-e", script],
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+        ctx.output({"app": app_name, "all": minimize_all, "minimized": True})
+    except subprocess.CalledProcessError as e:
+        ctx.error(f"Failed to minimize window: {e.stderr}")

macbot/context.py

@@ -0,0 +1,47 @@
+"""Shared context for macbot commands."""
+
+import json
+import sys
+
+import click
+
+
+class Context:
+    """Shared context for all commands."""
+
+    def __init__(self, json_output: bool = False):
+        self.json_output = json_output
+
+    def output(self, data: dict | list | str, success: bool = True):
+        """Output data in the appropriate format."""
+        if self.json_output:
+            if isinstance(data, str):
+                data = {"message": data, "success": success}
+            elif isinstance(data, (dict, list)):
+                if isinstance(data, dict) and "success" not in data:
+                    data = {**data, "success": success}
+            click.echo(json.dumps(data, indent=2, default=str))
+        else:
+            if isinstance(data, dict):
+                for key, value in data.items():
+                    if key != "success":
+                        click.echo(f"{key}: {value}")
+            elif isinstance(data, list):
+                for item in data:
+                    if isinstance(item, dict):
+                        click.echo(" | ".join(f"{k}: {v}" for k, v in item.items()))
+                    else:
+                        click.echo(item)
+            else:
+                click.echo(data)
+
+    def error(self, message: str, exit_code: int = 1):
+        """Output an error message and exit."""
+        if self.json_output:
+            click.echo(json.dumps({"error": message, "success": False}))
+        else:
+            click.echo(f"Error: {message}", err=True)
+        sys.exit(exit_code)
+
+
+pass_context = click.make_pass_decorator(Context, ensure=True)

macbot_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,210 @@
+Metadata-Version: 2.4
+Name: macbot-cli
+Version: 0.1.0
+Summary: macOS automation CLI for AI agents and developers
+Project-URL: Homepage, https://github.com/marcusbuildsthings-droid/macbot
+Project-URL: Repository, https://github.com/marcusbuildsthings-droid/macbot
+Project-URL: Issues, https://github.com/marcusbuildsthings-droid/macbot/issues
+Author-email: Marcus <marcus.builds.things@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai-agent,applescript,automation,cli,macos
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Environment :: MacOS X
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Requires-Dist: click>=8.0
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# macbot
+
+macOS automation CLI for AI agents and developers. Control notifications, clipboard, windows, audio, display, and more from the command line with optional JSON output.
+
+## Installation
+
+```bash
+pip install macbot-cli
+```
+
+## Quick Start
+
+```bash
+# Send a notification
+macbot notify "Build Complete" "All tests passed"
+
+# Get/set clipboard
+macbot clipboard get
+macbot clipboard set "Hello, World!"
+
+# Text-to-speech
+macbot say "Hello from macbot" --voice Daniel
+
+# Take a screenshot
+macbot screenshot ~/Desktop/screen.png
+
+# Volume control
+macbot audio volume 50
+macbot audio mute
+
+# WiFi control
+macbot wifi status
+macbot wifi networks
+```
+
+## Commands
+
+### Notifications
+```bash
+macbot notify "Title" "Message"
+macbot notify "Alert" --subtitle "Warning" --sound Ping
+```
+
+### Clipboard
+```bash
+macbot clipboard get         # Get contents
+macbot clipboard set "text"  # Set contents
+macbot clipboard clear       # Clear clipboard
+```
+
+### Text-to-Speech
+```bash
+macbot say "Hello"                    # Default voice
+macbot say "British" --voice Daniel   # Specific voice
+macbot say "Fast" --rate 300          # Faster speech
+macbot say "Save" --output speech.aiff # Save to file
+macbot say "" --list-voices           # List voices
+```
+
+### Screenshots
+```bash
+macbot screenshot                  # Desktop with timestamp
+macbot screenshot screen.png       # Specific file
+macbot screenshot --clipboard      # To clipboard
+macbot screenshot --window         # Front window
+macbot screenshot --interactive    # Select region
+macbot screenshot --delay 3        # 3 second delay
+```
+
+### Window Management
+```bash
+macbot window list                        # List all windows
+macbot window list --app Safari           # Filter by app
+macbot window focus Safari                # Focus app
+macbot window focus "VS Code" -t project  # Focus specific window
+macbot window move Safari -x 0 -y 0 -w 1200 -h 800
+macbot window minimize Safari
+```
+
+### Applications
+```bash
+macbot apps list                    # All installed apps
+macbot apps list --running          # Running apps only
+macbot apps launch Safari           # Launch app
+macbot apps launch Safari -b        # Launch in background
+macbot apps quit Safari             # Quit app
+macbot apps quit "Frozen" --force   # Force quit
+macbot apps hide Safari             # Hide app
+macbot apps show Safari             # Show/unhide app
+```
+
+### Audio
+```bash
+macbot audio volume              # Get volume
+macbot audio volume 50           # Set to 50%
+macbot audio mute                # Mute
+macbot audio mute --toggle       # Toggle mute
+macbot audio unmute              # Unmute
+macbot audio devices             # List devices
+macbot audio output "Speakers"   # Set output device
+macbot audio input "Microphone"  # Set input device
+```
+
+### Display Brightness
+```bash
+macbot brightness          # Get brightness
+macbot brightness 0.7      # Set to 70%
+macbot brightness 0.5 -d 1 # Set external display
+```
+
+Requires: `brew install brightness`
+
+### WiFi
+```bash
+macbot wifi status           # Status and IP
+macbot wifi on               # Turn on
+macbot wifi off              # Turn off
+macbot wifi networks         # List available
+macbot wifi connect "SSID" --password "pass"
+macbot wifi disconnect
+```
+
+### Bluetooth
+```bash
+macbot bluetooth status              # Power state
+macbot bluetooth on                  # Turn on
+macbot bluetooth off                 # Turn off
+macbot bluetooth devices             # List devices
+macbot bluetooth devices --connected # Connected only
+macbot bluetooth connect XX-XX-XX-XX-XX-XX
+macbot bluetooth disconnect XX-XX-XX-XX-XX-XX
+```
+
+Requires: `brew install blueutil`
+
+## JSON Output
+
+All commands support `--json` for machine-readable output:
+
+```bash
+macbot --json wifi status
+```
+
+```json
+{
+  "interface": "en0",
+  "power": "on",
+  "network": "MyNetwork",
+  "ip_address": "192.168.1.100",
+  "connected": true,
+  "success": true
+}
+```
+
+## Optional Dependencies
+
+Some commands require additional tools:
+
+```bash
+# Display brightness
+brew install brightness
+
+# Bluetooth control
+brew install blueutil
+
+# Audio device switching
+brew install switchaudio-osx
+```
+
+## For AI Agents
+
+See [SKILL.md](SKILL.md) for agent-optimized documentation.
+
+## License
+
+MIT