[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-6998":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":25,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":32,"readmeContent":33,"aiSummary":34,"trendingCount":16,"starSnapshotCount":16,"syncStatus":35,"lastSyncTime":36,"discoverSource":37},6998,"Peekaboo","openclaw\u002FPeekaboo","openclaw","Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.","http:\u002F\u002Fwww.peekaboo.boo\u002F",null,"Swift",4691,356,13,1,0,5,80,1010,33,29.66,"MIT License",false,"main",true,[27,28,29,30,31],"ai","macos","mcp","screenshots","swift","2026-06-12 02:01:33","# Peekaboo 🫣 - Mac automation that sees the screen and does the clicks.\n\n![Peekaboo Banner](assets\u002Fpeekaboo.png)\n\n[![npm package](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnpm_package-3.0.0--beta1-brightgreen?logo=npm&logoColor=white&style=flat-square)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@steipete\u002Fpeekaboo)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-ffd60a?style=flat-square)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![macOS 15.0+ (Sequoia)](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FmacOS-15.0%2B_(Sequoia)-0078d7?logo=apple&logoColor=white&style=flat-square)](https:\u002F\u002Fwww.apple.com\u002Fmacos\u002F)\n[![Swift 6.2](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSwift-6.2-F05138?logo=swift&logoColor=white&style=flat-square)](https:\u002F\u002Fswift.org\u002F)\n[![node >=22](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnode-%3E%3D22.0.0-2ea44f?logo=node.js&logoColor=white&style=flat-square)](https:\u002F\u002Fnodejs.org\u002F)\n[![Download macOS](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDownload-macOS-000000?logo=apple&logoColor=white&style=flat-square)](https:\u002F\u002Fgithub.com\u002Fsteipete\u002Fpeekaboo\u002Freleases\u002Flatest)\n[![Homebrew](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FHomebrew-steipete%2Ftap-b28f62?logo=homebrew&logoColor=white&style=flat-square)](https:\u002F\u002Fgithub.com\u002Fsteipete\u002Fhomebrew-tap)\n[![Ask DeepWiki](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FAsk-DeepWiki-0088cc?style=flat-square)](https:\u002F\u002Fdeepwiki.com\u002Fsteipete\u002Fpeekaboo)\n\nPeekaboo brings high-fidelity screen capture, AI analysis, and complete GUI automation to macOS. Version 3 adds native agent flows and multi-screen automation across the CLI and MCP server.\n> Note: v3 is currently in beta (3.0.0-beta4) and has a few known issues; see the changelog for details.\n\n## What you get\n- Pixel-accurate captures (windows, screens, menu bar) with optional Retina 2x scaling.\n- Natural-language agent that chains Peekaboo tools (see, click, type, scroll, hotkey, menu, window, app, dock, space).\n- Menu and menubar discovery with structured JSON; no clicks required.\n- Multi-provider AI: GPT-5.1 family, Claude 4.x, Grok 4-fast (vision), Gemini 2.5, and local Ollama models.\n- MCP server for Claude Desktop and Cursor plus a native CLI; the same tools in both.\n- Configurable, testable workflows with reproducible sessions and strict typing.\n- Requires macOS Screen Recording + Accessibility permissions (see [docs\u002Fpermissions.md](docs\u002Fpermissions.md)).\n\n## Install\n- macOS app + CLI (Homebrew):\n  ```bash\n  brew install steipete\u002Ftap\u002Fpeekaboo\n  ```\n- MCP server (Node 22+, no global install needed):\n  ```bash\n  npx -y @steipete\u002Fpeekaboo\n  ```\n\n## Quick start\n```bash\n# Capture full screen at Retina scale and save to Desktop\npeekaboo image --mode screen --retina --path ~\u002FDesktop\u002Fscreen.png\n\n# Click a button by label (captures, resolves, and clicks in one go)\npeekaboo see --app Safari --json | jq -r '.data.snapshot_id' | read SNAPSHOT\npeekaboo click --on \"Reload this page\" --snapshot \"$SNAPSHOT\"\n\n# Run a natural-language automation\npeekaboo agent \"Open Notes and create a TODO list with three items\"\n\n# Run as an MCP server (Claude\u002FCursor)\nnpx -y @steipete\u002Fpeekaboo\n\n# Minimal Claude Desktop config snippet (Developer → Edit Config):\n# {\n#   \"mcpServers\": {\n#     \"peekaboo\": {\n#       \"command\": \"npx\",\n#       \"args\": [\"-y\", \"@steipete\u002Fpeekaboo\"],\n#       \"env\": {\n#         \"PEEKABOO_AI_PROVIDERS\": \"openai\u002Fgpt-5.1,anthropic\u002Fclaude-opus-4\"\n#       }\n#     }\n#   }\n# }\n```\n\n## Shell completions\n\nPeekaboo can generate shell-native completions directly from the same Commander\nmetadata that powers CLI help and docs:\n\n```bash\n# Current shell (recommended)\neval \"$(peekaboo completions $SHELL)\"\n\n# Explicit shells\neval \"$(peekaboo completions zsh)\"\neval \"$(peekaboo completions bash)\"\npeekaboo completions fish | source\n```\n\nFor persistent setup and troubleshooting, see\n[docs\u002Fcommands\u002Fcompletions.md](docs\u002Fcommands\u002Fcompletions.md).\n\n| Command | Key flags \u002F subcommands | What it does |\n| --- | --- | --- |\n| [see](docs\u002Fcommands\u002Fsee.md) | `--app`, `--mode screen\u002Fwindow`, `--retina`, `--json` | Capture and annotate UI, return snapshot + element IDs |\n| [click](docs\u002Fcommands\u002Fclick.md) | `--on \u003Cid\u002Fquery>`, `--snapshot`, `--wait`, coords | Click by element ID, label, or coordinates |\n| [type](docs\u002Fcommands\u002Ftype.md) | `--text`, `--clear`, `--delay-ms` | Enter text with pacing options |\n| [press](docs\u002Fcommands\u002Fpress.md) | key names, `--repeat` | Special keys and sequences |\n| [hotkey](docs\u002Fcommands\u002Fhotkey.md) | combos like `cmd,shift,t` | Modifier combos (cmd\u002Fctrl\u002Falt\u002Fshift) |\n| [scroll](docs\u002Fcommands\u002Fscroll.md) | `--on \u003Cid>`, `--direction up\u002Fdown`, `--ticks` | Scroll views or elements |\n| [swipe](docs\u002Fcommands\u002Fswipe.md) | `--from\u002F--to`, `--duration`, `--steps` | Smooth gesture-style drags |\n| [drag](docs\u002Fcommands\u002Fdrag.md) | `--from\u002F--to`, modifiers, Dock\u002FTrash targets | Drag-and-drop between elements\u002Fcoords |\n| [move](docs\u002Fcommands\u002Fmove.md) | `--to \u003Cid\u002Fcoords>`, `--screen-index` | Position the cursor without clicking |\n| [window](docs\u002Fcommands\u002Fwindow.md) | `list`, `move`, `resize`, `focus`, `set-bounds` | Move\u002Fresize\u002Ffocus windows and Spaces |\n| [app](docs\u002Fcommands\u002Fapp.md) | `launch`, `quit`, `relaunch`, `switch`, `list` | Launch, quit, relaunch, switch apps |\n| [space](docs\u002Fcommands\u002Fspace.md) | `list`, `switch`, `move-window` | List or switch macOS Spaces |\n| [menu](docs\u002Fcommands\u002Fmenu.md) | `list`, `list-all`, `click`, `click-extra` | List\u002Fclick app menus and extras |\n| [menubar](docs\u002Fcommands\u002Fmenubar.md) | `list`, `click` | Target status-bar items by name\u002Findex |\n| [dock](docs\u002Fcommands\u002Fdock.md) | `launch`, `right-click`, `hide`, `show`, `list` | Interact with Dock items |\n| [dialog](docs\u002Fcommands\u002Fdialog.md) | `list`, `click`, `input`, `file`, `dismiss` | Drive system dialogs (open\u002Fsave\u002Fetc.) |\n| [image](docs\u002Fcommands\u002Fimage.md) | `--mode screen\u002Fwindow\u002Fmenu`, `--retina`, `--analyze` | Screenshot screen\u002Fwindow\u002Fmenu bar (+analyze) |\n| [list](docs\u002Fcommands\u002Flist.md) | `apps`, `windows`, `screens`, `menubar`, `permissions` | Enumerate apps, windows, screens, permissions |\n| [tools](docs\u002Fcommands\u002Ftools.md) | `--verbose`, `--json`, `--no-sort` | Inspect native Peekaboo tools |\n| [completions](docs\u002Fcommands\u002Fcompletions.md) | `[shell]` | Generate zsh\u002Fbash\u002Ffish completion scripts from Commander metadata |\n| [config](docs\u002Fcommands\u002Fconfig.md) | `init`, `show`, `add`, `login`, `models` | Manage credentials\u002Fproviders\u002Fsettings |\n| [permissions](docs\u002Fcommands\u002Fpermissions.md) | `status`, `grant` | Check\u002Fgrant required macOS permissions |\n| [run](docs\u002Fcommands\u002Frun.md) | `.peekaboo.json`, `--output`, `--no-fail-fast` | Execute `.peekaboo.json` automation scripts |\n| [sleep](docs\u002Fcommands\u002Fsleep.md) | `--duration` (ms) | Millisecond delays between steps |\n| [clean](docs\u002Fcommands\u002Fclean.md) | `--all-snapshots`, `--older-than`, `--snapshot` | Prune snapshots and caches |\n| [agent](docs\u002Fcommands\u002Fagent.md) | `--model`, `--dry-run`, `--resume`, `--max-steps`, audio | Natural-language multi-step automation |\n| [mcp](docs\u002Fcommands\u002Fmcp.md) | `serve` (default) | Run Peekaboo as an MCP server |\n\n## Models and providers\n- OpenAI: GPT-5.1 (default) and GPT-4.1\u002F4o vision\n- Anthropic: Claude 4.x\n- xAI: Grok 4-fast reasoning + vision\n- Google: Gemini 2.5 (pro\u002Fflash)\n- Local: Ollama (llama3.3, llava, etc.)\n\nSet providers via `PEEKABOO_AI_PROVIDERS` or `peekaboo config add`.\n\n## Learn more\n- Command reference: [docs\u002Fcommands\u002F](docs\u002Fcommands\u002F)\n- Architecture: [docs\u002FARCHITECTURE.md](docs\u002FARCHITECTURE.md)\n- Building from source: [docs\u002Fbuilding.md](docs\u002Fbuilding.md)\n- Testing guide: [docs\u002Ftesting\u002Ftools.md](docs\u002Ftesting\u002Ftools.md)\n- MCP setup: [docs\u002Fcommands\u002Fmcp.md](docs\u002Fcommands\u002Fmcp.md)\n- Permissions: [docs\u002Fpermissions.md](docs\u002Fpermissions.md)\n- Ollama\u002Flocal models: [docs\u002Follama.md](docs\u002Follama.md)\n- Agent chat loop: [docs\u002Fagent-chat.md](docs\u002Fagent-chat.md)\n- Service API reference: [docs\u002Fservice-api-reference.md](docs\u002Fservice-api-reference.md)\n\n## Community\n\n- [PeekabooWin](https:\u002F\u002Fgithub.com\u002FFelixKruger\u002FPeekabooWin) — Windows-first rewrite of the Peekaboo automation loop (JavaScript + PowerShell) by [@FelixKruger](https:\u002F\u002Fgithub.com\u002FFelixKruger)\n\n## Development basics\n- Requirements: macOS 15+, Xcode 16+\u002FSwift 6.2. Node 22+ only if you run the pnpm docs\u002Fbuild helper scripts (core CLI\u002Fapp\u002FMCP are Swift-only).\n- Install deps: `pnpm install` then `pnpm run build:cli` or `pnpm run test:safe`.\n- Lint\u002Fformat: `pnpm run lint && pnpm run format`.\n\n## License\nMIT\n","Peekaboo 是一个 macOS 命令行工具及可选的 MCP 服务器，能够通过本地或远程 AI 模型捕获应用程序或整个系统的屏幕截图，并提供视觉问答功能。其核心功能包括高精度屏幕捕捉、自然语言处理和完整的 GUI 自动化操作，支持多种 AI 模型如 GPT-5.1、Claude 4.x 等。此外，它还具备多屏幕自动化能力和结构化的菜单栏发现功能，无需手动点击即可获取信息。适用于需要自动化测试、用户界面交互模拟以及基于屏幕内容进行智能分析的场景。",2,"2026-06-11 03:10:04","top_language"]