{
  "markdown": "# ControlMac - Gemini CLI Extension\n\n[![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-Extension-blue)](https://geminicli.com/extensions/)\n[![npm](https://img.shields.io/npm/v/controlmac-mcp)](https://www.npmjs.com/package/controlmac-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nControl macOS via AppleScript directly from Gemini CLI. This extension provides 27 tools for system control, app management, notifications, clipboard, and Finder operations.\n\n## Installation\n\n### From Extensions Gallery (Recommended)\n\n```bash\ngemini extensions install controlmac\n```\n\n### Manual Installation\n\n```bash\n# Clone the extension\ngit clone https://github.com/ramgeart/controlmac-gemini-extension.git ~/.gemini/extensions/controlmac\n\n# Or copy to extensions directory\ncp -r controlmac-gemini-extension ~/.gemini/extensions/controlmac\n```\n\n### Direct MCP Configuration\n\nAdd to `~/.gemini/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"controlmac\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"controlmac-mcp\"],\n      \"trust\": true\n    }\n  }\n}\n```\n\n## Features\n\n| Category | Tools |\n|----------|-------|\n| **Core** | Execute AppleScript/JXA code |\n| **System** | Volume, brightness, dark mode, system info, sleep, trash |\n| **Apps** | Open, quit, list, hide, show, get windows |\n| **Notifications** | Notifications, dialogs, alerts, text-to-speech |\n| **Clipboard** | Get, set, clear |\n| **Finder** | Open paths, reveal, selected files, new window, open URLs |\n\n## Usage\n\nOnce installed, just ask Gemini naturally:\n\n```\n> Set the volume to 30%\n> Open Safari\n> Show me what apps are running\n> Enable dark mode\n> Display a notification saying \"Hello World\"\n> What's in my clipboard?\n> Open my Downloads folder\n```\n\n## Verify Installation\n\n```bash\n# Check if the extension is loaded\ngemini> /mcp\n\n# See available tools\ngemini> /mcp desc controlmac\n```\n\n## Requirements\n\n- macOS (uses AppleScript)\n- Node.js 18+\n- Gemini CLI\n\n## Available Tools\n\n- `macos_osascript` - Execute AppleScript/JXA\n- `macos_set_volume` / `macos_get_volume` / `macos_set_mute`\n- `macos_set_brightness`\n- `macos_get_system_info`\n- `macos_sleep_display`\n- `macos_empty_trash`\n- `macos_set_dark_mode` / `macos_get_dark_mode`\n- `macos_open_app` / `macos_quit_app` / `macos_list_apps`\n- `macos_get_frontmost_app` / `macos_hide_app` / `macos_show_all_apps`\n- `macos_get_app_windows`\n- `macos_notification` / `macos_dialog` / `macos_alert` / `macos_speak`\n- `macos_get_clipboard` / `macos_set_clipboard` / `macos_clear_clipboard`\n- `macos_open_path` / `macos_reveal_in_finder`\n- `macos_get_selected_files` / `macos_get_finder_path`\n- `macos_new_finder_window` / `macos_open_url`\n\n## Related\n\n- [controlmac-mcp](https://github.com/ramgeart/controlmac-mcp) - The underlying MCP server (also works with Claude Desktop)\n- [Gemini CLI Extensions](https://geminicli.com/docs/extensions/)\n- [MCP Servers Guide](https://geminicli.com/docs/tools/mcp-server/)\n\n## License\n\nMIT\n",
  "bytes": 3000,
  "sha": "b51fc080e3dfc0388bdc556bae7807d39c952a841b3dbbe8be613c233c151ffa",
  "repo_slug": "ramgeart/controlmac-gemini-extension",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_ramgeart_controlmac_gemini_extension_51d58e92/readme"
}