{
  "markdown": "# Screenshot Anything (macOS only)\n\nA Gemini CLI extension that gives the AI the ability to see your screen. Capture full screen or specific application windows on-demand for visual debugging, UI analysis, and context gathering.\n\n## Features\n\n- **On-Demand Capture**: Screenshots are only taken when you ask (e.g., \"Look at my screen\")\n- **Window Locking**: Focus captures on a specific application window using fuzzy search\n- **Smart Countdown**: 3-second visual countdown for full-screen captures; instant capture for locked windows\n- **Optimized Images**: Automatically resized and compressed for fast response times\n- **Session History**: View previously captured screenshots from the current session\n- **Multi-Display Support**: Capture from any connected display\n- **Local Privacy**: Images are processed locally and saved to a session folder for your reference\n\n## Requirements\n\n- **macOS** (this extension uses macOS-specific APIs)\n- **Node.js** v18 or later\n- **Xcode Command Line Tools** (for window enumeration)\n  ```bash\n  xcode-select --install\n  ```\n- **Screen Recording Permission** (you'll be prompted on first use)\n\n## Installation\n\n### From GitHub\n\n```bash\ngemini extensions install https://github.com/LyalinDotCom/ScreenshotExtension\n```\n\nThe extension will automatically build during installation.\n\n### Local Development\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/LyalinDotCom/ScreenshotExtension.git\n   cd ScreenshotExtension\n   ```\n\n2. Install dependencies:\n   ```bash\n   npm install\n   ```\n\n3. Link to Gemini CLI:\n   ```bash\n   gemini extensions link .\n   ```\n\n## Usage\n\nOnce installed, Gemini will automatically use the screenshot tool when you ask it to look at your screen.\n\n### Natural Language Examples\n\n- \"Look at my screen and tell me what error is in the console.\"\n- \"Take a screenshot and analyze the layout of this web page.\"\n- \"I'm stuck on this screen, what should I click?\"\n- \"What version number is shown in the bottom corner?\"\n\n### Custom Commands\n\n| Command | Description |\n|---------|-------------|\n| `/shot` | Take a screenshot of the full screen or locked window |\n| `/list` | List all open visible windows |\n| `/lock <query>` | Lock captures to a window matching the query (e.g., `/lock Chrome`) |\n| `/clear` | Clear the window lock, revert to full screen capture |\n\n### Window Locking Workflow\n\n1. Use `/list` to see all available windows\n2. Use `/lock VS Code` to focus on a specific window\n3. Use `/shot` or ask naturally - captures will only show that window\n4. Use `/clear` to go back to full screen capture\n\n## MCP Tools\n\nThis extension provides the following tools to the AI:\n\n| Tool | Description |\n|------|-------------|\n| `take_screenshot` | Captures the screen or locked window, returns the image |\n| `view_screenshot_history` | Lists or retrieves previously captured screenshots |\n| `list_windows` | Lists all visible application windows |\n| `focus_window` | Locks capture to a specific window by fuzzy search |\n| `clear_lock` | Removes the window lock |\n\n## Limitations\n\n- **macOS only**: Uses CoreGraphics APIs and `screencapture` utility\n- **Screen Recording permission required**: Must be granted in System Settings\n- **Xcode CLI tools required**: Needed for Swift-based window enumeration\n- **3-second countdown**: For full-screen captures only (locked windows capture instantly)\n\n## Troubleshooting\n\n### Permission Denied\n\nOn first run, macOS will prompt you to allow screen recording. If you denied it:\n\n1. Go to **System Settings > Privacy & Security > Screen Recording**\n2. Enable the toggle for your Terminal app (Terminal, iTerm, VS Code, etc.)\n3. Restart your terminal and the Gemini CLI\n\n### Window List Empty or Missing Apps\n\nEnsure Xcode Command Line Tools are installed:\n```bash\nxcode-select --install\n```\n\n### Multiple Displays\n\nThe extension defaults to the primary display (index 0). To capture another display, mention it in your prompt (e.g., \"take a screenshot of my second monitor\").\n\n## File Storage\n\nScreenshots are saved locally to:\n```\n./captures/session-{uuid}/\n```\n\nEach session gets a unique folder. Images are saved as compressed JPEGs (1280px width, 80% quality).\n\n## License\n\nMIT\n",
  "bytes": 4194,
  "sha": "89bbbc4ca7feedf6c38feeb6823369cc8cce39e4ec22370db94f92e6c48974ad",
  "repo_slug": "lyalindotcom/screenshotextension",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_lyalindotcom_screenshotextension_4b9c5ff3/readme"
}