macbot-cli 0.1.0__tar.gz

macbot_cli-0.1.0/.gitignore

@@ -0,0 +1,30 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+.env
+.venv
+env/
+venv/
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.mypy_cache/
+.ruff_cache/

macbot_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marcus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

macbot_cli-0.1.0/PKG-INFO

@@ -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

macbot_cli-0.1.0/README.md

@@ -0,0 +1,176 @@
+# 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

macbot_cli-0.1.0/SKILL.md

@@ -0,0 +1,169 @@
+# macbot Skill
+
+macOS automation CLI with JSON output for AI agent consumption.
+
+## Prerequisites
+
+- macOS (tested on Ventura+)
+- Python 3.9+
+- Optional: `brew install brightness blueutil switchaudio-osx`
+
+## Installation
+
+```bash
+pip install macbot-cli
+```
+
+## Command Reference
+
+| Command | Description |
+|---------|-------------|
+| `macbot notify "Title" "Msg"` | Send notification |
+| `macbot clipboard get\|set\|clear` | Clipboard ops |
+| `macbot say "text"` | Text-to-speech |
+| `macbot screenshot [path]` | Take screenshot |
+| `macbot window list\|focus\|move\|minimize` | Window management |
+| `macbot apps list\|launch\|quit\|hide\|show` | App control |
+| `macbot audio volume\|mute\|unmute\|devices\|output\|input` | Audio control |
+| `macbot brightness [0.0-1.0]` | Display brightness |
+| `macbot wifi status\|on\|off\|networks\|connect\|disconnect` | WiFi control |
+| `macbot bluetooth status\|on\|off\|devices\|connect\|disconnect\|pair\|unpair` | Bluetooth |
+
+## JSON Output
+
+**Always use `--json` flag for automation:**
+
+```bash
+macbot --json <command>
+```
+
+All responses include `"success": true|false`.
+
+## Common Patterns
+
+### Check System State
+```bash
+# WiFi status
+macbot --json wifi status
+# Returns: {"interface": "en0", "power": "on", "network": "...", "connected": true}
+
+# Audio status
+macbot --json audio volume
+# Returns: {"volume": 50}
+
+# Running apps
+macbot --json apps list --running
+# Returns: {"apps": [{"name": "...", "running": true}], "count": N}
+```
+
+### System Control
+```bash
+# Set volume to 50%
+macbot --json audio volume 50
+
+# Mute/unmute
+macbot --json audio mute
+macbot --json audio unmute
+
+# WiFi on/off
+macbot --json wifi on
+macbot --json wifi off
+
+# Bluetooth
+macbot --json bluetooth on
+macbot --json bluetooth off
+```
+
+### Notifications
+```bash
+macbot --json notify "Title" "Message body"
+macbot --json notify "Alert" --subtitle "Warning" --sound Ping
+```
+
+### Clipboard
+```bash
+# Read
+macbot --json clipboard get
+# Returns: {"content": "...", "length": N}
+
+# Write
+macbot --json clipboard set "text to copy"
+```
+
+### Screenshots
+```bash
+# Save to file
+macbot --json screenshot /path/to/output.png
+# Returns: {"captured": true, "path": "...", "exists": true, "size": N}
+
+# To clipboard
+macbot --json screenshot --clipboard
+
+# Front window only
+macbot --json screenshot --window /path/to/window.png
+```
+
+### Window Management
+```bash
+# List all windows
+macbot --json window list
+# Returns: {"windows": [{"app": "...", "title": "...", "x": 0, "y": 0, "width": N, "height": N}]}
+
+# Focus app
+macbot --json window focus Safari
+
+# Move/resize
+macbot --json window move Safari --x 0 --y 0 --width 1200 --height 800
+```
+
+### App Control
+```bash
+# Launch
+macbot --json apps launch Safari
+
+# Quit
+macbot --json apps quit Safari
+macbot --json apps quit "Frozen App" --force
+
+# Hide/show
+macbot --json apps hide Safari
+macbot --json apps show Safari
+```
+
+### Text-to-Speech
+```bash
+# Speak
+macbot --json say "Hello world"
+
+# Specific voice
+macbot --json say "British accent" --voice Daniel
+
+# Save to file
+macbot --json say "Save this" --output speech.aiff
+# Returns: {"saved": true, "output": "speech.aiff"}
+
+# List voices
+macbot --json say "" --list-voices
+```
+
+## Error Handling
+
+Errors return non-zero exit code and JSON:
+```json
+{"error": "Description", "success": false}
+```
+
+## Dependencies
+
+| Feature | Dependency | Install |
+|---------|-----------|---------|
+| Brightness | brightness | `brew install brightness` |
+| Bluetooth | blueutil | `brew install blueutil` |
+| Audio devices | SwitchAudioSource | `brew install switchaudio-osx` |
+
+Commands will error with install instructions if dependencies are missing.
+
+## Exit Codes
+
+- `0` - Success
+- `1` - Error (details in JSON/stderr)

macbot_cli-0.1.0/pyproject.toml

@@ -0,0 +1,67 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "macbot-cli"
+version = "0.1.0"
+description = "macOS automation CLI for AI agents and developers"
+readme = "README.md"
+license = "MIT"
+authors = [
+    { name = "Marcus", email = "marcus.builds.things@gmail.com" }
+]
+keywords = ["macos", "automation", "cli", "ai-agent", "applescript"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Environment :: MacOS X",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: System :: Systems Administration",
+    "Topic :: Utilities",
+]
+requires-python = ">=3.9"
+dependencies = [
+    "click>=8.0",
+    "rich>=13.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+    "black>=23.0",
+    "ruff>=0.1.0",
+]
+
+[project.scripts]
+macbot = "macbot.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/marcusbuildsthings-droid/macbot"
+Repository = "https://github.com/marcusbuildsthings-droid/macbot"
+Issues = "https://github.com/marcusbuildsthings-droid/macbot/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/macbot"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W"]
+
+[tool.black]
+line-length = 100
+target-version = ["py39"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

macbot_cli-0.1.0/src/macbot/__init__.py

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