{
  "schemaVersion": "1.0",
  "item": {
    "slug": "peekaboo",
    "name": "Peekaboo",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/steipete/peekaboo",
    "canonicalUrl": "https://clawhub.ai/steipete/peekaboo",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/peekaboo",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=peekaboo",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/peekaboo"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/peekaboo",
    "agentPageUrl": "https://openagent3.xyz/skills/peekaboo/agent",
    "manifestUrl": "https://openagent3.xyz/skills/peekaboo/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/peekaboo/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Peekaboo",
        "body": "Peekaboo is a full macOS UI automation CLI: capture/inspect screens, target UI\nelements, drive input, and manage apps/windows/menus. Commands share a snapshot\ncache and support --json/-j for scripting. Run peekaboo or\npeekaboo <cmd> --help for flags; peekaboo --version prints build metadata.\nTip: run via polter peekaboo to ensure fresh builds."
      },
      {
        "title": "Features (all CLI capabilities, excluding agent/MCP)",
        "body": "Core\n\nbridge: inspect Peekaboo Bridge host connectivity\ncapture: live capture or video ingest + frame extraction\nclean: prune snapshot cache and temp files\nconfig: init/show/edit/validate, providers, models, credentials\nimage: capture screenshots (screen/window/menu bar regions)\nlearn: print the full agent guide + tool catalog\nlist: apps, windows, screens, menubar, permissions\npermissions: check Screen Recording/Accessibility status\nrun: execute .peekaboo.json scripts\nsleep: pause execution for a duration\ntools: list available tools with filtering/display options\n\nInteraction\n\nclick: target by ID/query/coords with smart waits\ndrag: drag & drop across elements/coords/Dock\nhotkey: modifier combos like cmd,shift,t\nmove: cursor positioning with optional smoothing\npaste: set clipboard -> paste -> restore\npress: special-key sequences with repeats\nscroll: directional scrolling (targeted + smooth)\nswipe: gesture-style drags between targets\ntype: text + control keys (--clear, delays)\n\nSystem\n\napp: launch/quit/relaunch/hide/unhide/switch/list apps\nclipboard: read/write clipboard (text/images/files)\ndialog: click/input/file/dismiss/list system dialogs\ndock: launch/right-click/hide/show/list Dock items\nmenu: click/list application menus + menu extras\nmenubar: list/click status bar items\nopen: enhanced open with app targeting + JSON payloads\nspace: list/switch/move-window (Spaces)\nvisualizer: exercise Peekaboo visual feedback animations\nwindow: close/minimize/maximize/move/resize/focus/list\n\nVision\n\nsee: annotated UI maps, snapshot IDs, optional analysis\n\nGlobal runtime flags\n\n--json/-j, --verbose/-v, --log-level <level>\n--no-remote, --bridge-socket <path>"
      },
      {
        "title": "Quickstart (happy path)",
        "body": "peekaboo permissions\npeekaboo list apps --json\npeekaboo see --annotate --path /tmp/peekaboo-see.png\npeekaboo click --on B1\npeekaboo type \"Hello\" --return"
      },
      {
        "title": "Common targeting parameters (most interaction commands)",
        "body": "App/window: --app, --pid, --window-title, --window-id, --window-index\nSnapshot targeting: --snapshot (ID from see; defaults to latest)\nElement/coords: --on/--id (element ID), --coords x,y\nFocus control: --no-auto-focus, --space-switch, --bring-to-current-space,\n--focus-timeout-seconds, --focus-retry-count"
      },
      {
        "title": "Common capture parameters",
        "body": "Output: --path, --format png|jpg, --retina\nTargeting: --mode screen|window|frontmost, --screen-index,\n--window-title, --window-id\nAnalysis: --analyze \"prompt\", --annotate\nCapture engine: --capture-engine auto|classic|cg|modern|sckit"
      },
      {
        "title": "Common motion/typing parameters",
        "body": "Timing: --duration (drag/swipe), --steps, --delay (type/scroll/press)\nHuman-ish movement: --profile human|linear, --wpm (typing)\nScroll: --direction up|down|left|right, --amount <ticks>, --smooth"
      },
      {
        "title": "See -> click -> type (most reliable flow)",
        "body": "peekaboo see --app Safari --window-title \"Login\" --annotate --path /tmp/see.png\npeekaboo click --on B3 --app Safari\npeekaboo type \"user@example.com\" --app Safari\npeekaboo press tab --count 1 --app Safari\npeekaboo type \"supersecret\" --app Safari --return"
      },
      {
        "title": "Target by window id",
        "body": "peekaboo list windows --app \"Visual Studio Code\" --json\npeekaboo click --window-id 12345 --coords 120,160\npeekaboo type \"Hello from Peekaboo\" --window-id 12345"
      },
      {
        "title": "Capture screenshots + analyze",
        "body": "peekaboo image --mode screen --screen-index 0 --retina --path /tmp/screen.png\npeekaboo image --app Safari --window-title \"Dashboard\" --analyze \"Summarize KPIs\"\npeekaboo see --mode screen --screen-index 0 --analyze \"Summarize the dashboard\""
      },
      {
        "title": "Live capture (motion-aware)",
        "body": "peekaboo capture live --mode region --region 100,100,800,600 --duration 30 \\\n  --active-fps 8 --idle-fps 2 --highlight-changes --path /tmp/capture"
      },
      {
        "title": "App + window management",
        "body": "peekaboo app launch \"Safari\" --open https://example.com\npeekaboo window focus --app Safari --window-title \"Example\"\npeekaboo window set-bounds --app Safari --x 50 --y 50 --width 1200 --height 800\npeekaboo app quit --app Safari"
      },
      {
        "title": "Menus, menubar, dock",
        "body": "peekaboo menu click --app Safari --item \"New Window\"\npeekaboo menu click --app TextEdit --path \"Format > Font > Show Fonts\"\npeekaboo menu click-extra --title \"WiFi\"\npeekaboo dock launch Safari\npeekaboo menubar list --json"
      },
      {
        "title": "Mouse + gesture input",
        "body": "peekaboo move 500,300 --smooth\npeekaboo drag --from B1 --to T2\npeekaboo swipe --from-coords 100,500 --to-coords 100,200 --duration 800\npeekaboo scroll --direction down --amount 6 --smooth"
      },
      {
        "title": "Keyboard input",
        "body": "peekaboo hotkey --keys \"cmd,shift,t\"\npeekaboo press escape\npeekaboo type \"Line 1\\nLine 2\" --delay 10\n\nNotes\n\nRequires Screen Recording + Accessibility permissions.\nUse peekaboo see --annotate to identify targets before clicking."
      }
    ],
    "body": "Peekaboo\n\nPeekaboo is a full macOS UI automation CLI: capture/inspect screens, target UI elements, drive input, and manage apps/windows/menus. Commands share a snapshot cache and support --json/-j for scripting. Run peekaboo or peekaboo <cmd> --help for flags; peekaboo --version prints build metadata. Tip: run via polter peekaboo to ensure fresh builds.\n\nFeatures (all CLI capabilities, excluding agent/MCP)\n\nCore\n\nbridge: inspect Peekaboo Bridge host connectivity\ncapture: live capture or video ingest + frame extraction\nclean: prune snapshot cache and temp files\nconfig: init/show/edit/validate, providers, models, credentials\nimage: capture screenshots (screen/window/menu bar regions)\nlearn: print the full agent guide + tool catalog\nlist: apps, windows, screens, menubar, permissions\npermissions: check Screen Recording/Accessibility status\nrun: execute .peekaboo.json scripts\nsleep: pause execution for a duration\ntools: list available tools with filtering/display options\n\nInteraction\n\nclick: target by ID/query/coords with smart waits\ndrag: drag & drop across elements/coords/Dock\nhotkey: modifier combos like cmd,shift,t\nmove: cursor positioning with optional smoothing\npaste: set clipboard -> paste -> restore\npress: special-key sequences with repeats\nscroll: directional scrolling (targeted + smooth)\nswipe: gesture-style drags between targets\ntype: text + control keys (--clear, delays)\n\nSystem\n\napp: launch/quit/relaunch/hide/unhide/switch/list apps\nclipboard: read/write clipboard (text/images/files)\ndialog: click/input/file/dismiss/list system dialogs\ndock: launch/right-click/hide/show/list Dock items\nmenu: click/list application menus + menu extras\nmenubar: list/click status bar items\nopen: enhanced open with app targeting + JSON payloads\nspace: list/switch/move-window (Spaces)\nvisualizer: exercise Peekaboo visual feedback animations\nwindow: close/minimize/maximize/move/resize/focus/list\n\nVision\n\nsee: annotated UI maps, snapshot IDs, optional analysis\n\nGlobal runtime flags\n\n--json/-j, --verbose/-v, --log-level <level>\n--no-remote, --bridge-socket <path>\nQuickstart (happy path)\npeekaboo permissions\npeekaboo list apps --json\npeekaboo see --annotate --path /tmp/peekaboo-see.png\npeekaboo click --on B1\npeekaboo type \"Hello\" --return\n\nCommon targeting parameters (most interaction commands)\nApp/window: --app, --pid, --window-title, --window-id, --window-index\nSnapshot targeting: --snapshot (ID from see; defaults to latest)\nElement/coords: --on/--id (element ID), --coords x,y\nFocus control: --no-auto-focus, --space-switch, --bring-to-current-space, --focus-timeout-seconds, --focus-retry-count\nCommon capture parameters\nOutput: --path, --format png|jpg, --retina\nTargeting: --mode screen|window|frontmost, --screen-index, --window-title, --window-id\nAnalysis: --analyze \"prompt\", --annotate\nCapture engine: --capture-engine auto|classic|cg|modern|sckit\nCommon motion/typing parameters\nTiming: --duration (drag/swipe), --steps, --delay (type/scroll/press)\nHuman-ish movement: --profile human|linear, --wpm (typing)\nScroll: --direction up|down|left|right, --amount <ticks>, --smooth\nExamples\nSee -> click -> type (most reliable flow)\npeekaboo see --app Safari --window-title \"Login\" --annotate --path /tmp/see.png\npeekaboo click --on B3 --app Safari\npeekaboo type \"user@example.com\" --app Safari\npeekaboo press tab --count 1 --app Safari\npeekaboo type \"supersecret\" --app Safari --return\n\nTarget by window id\npeekaboo list windows --app \"Visual Studio Code\" --json\npeekaboo click --window-id 12345 --coords 120,160\npeekaboo type \"Hello from Peekaboo\" --window-id 12345\n\nCapture screenshots + analyze\npeekaboo image --mode screen --screen-index 0 --retina --path /tmp/screen.png\npeekaboo image --app Safari --window-title \"Dashboard\" --analyze \"Summarize KPIs\"\npeekaboo see --mode screen --screen-index 0 --analyze \"Summarize the dashboard\"\n\nLive capture (motion-aware)\npeekaboo capture live --mode region --region 100,100,800,600 --duration 30 \\\n  --active-fps 8 --idle-fps 2 --highlight-changes --path /tmp/capture\n\nApp + window management\npeekaboo app launch \"Safari\" --open https://example.com\npeekaboo window focus --app Safari --window-title \"Example\"\npeekaboo window set-bounds --app Safari --x 50 --y 50 --width 1200 --height 800\npeekaboo app quit --app Safari\n\nMenus, menubar, dock\npeekaboo menu click --app Safari --item \"New Window\"\npeekaboo menu click --app TextEdit --path \"Format > Font > Show Fonts\"\npeekaboo menu click-extra --title \"WiFi\"\npeekaboo dock launch Safari\npeekaboo menubar list --json\n\nMouse + gesture input\npeekaboo move 500,300 --smooth\npeekaboo drag --from B1 --to T2\npeekaboo swipe --from-coords 100,500 --to-coords 100,200 --duration 800\npeekaboo scroll --direction down --amount 6 --smooth\n\nKeyboard input\npeekaboo hotkey --keys \"cmd,shift,t\"\npeekaboo press escape\npeekaboo type \"Line 1\\nLine 2\" --delay 10\n\n\nNotes\n\nRequires Screen Recording + Accessibility permissions.\nUse peekaboo see --annotate to identify targets before clicking."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/steipete/peekaboo",
    "publisherUrl": "https://clawhub.ai/steipete/peekaboo",
    "owner": "steipete",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/peekaboo",
    "downloadUrl": "https://openagent3.xyz/downloads/peekaboo",
    "agentUrl": "https://openagent3.xyz/skills/peekaboo/agent",
    "manifestUrl": "https://openagent3.xyz/skills/peekaboo/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/peekaboo/agent.md"
  }
}