@assemblyline-agents/peekaboo

Official same-host macOS computer-use plugin backed by Peekaboo's stdio MCP server.

Requirements

• macOS 15 or newer
• a local Assembly Line gateway on the Mac being controlled
• Accessibility and Screen Recording permission for the host process

Hosted gateways cannot reach back to the Mac. Validation warns and deployment rejects that combination.

Configure

brew install steipete/tap/peekaboo
peekaboo permissions status
assembly-line add peekaboo agent

Keep the gateway local in agent.md:

deploy: local

The plugin's reviewed tools activate when selected. To inspect without acting, disable its write actions through the connection exception:

capabilities:
  peekaboo:
    connections:
      peekaboo:
        disable:
          - click
          - type
          - hotkey
          - scroll
          - drag
          - swipe
          - move
          - set_value
          - perform_action
          - app
          - window
          - menu
          - dock
          - dialog
          - space

Or require approval for selected actions:

capabilities:
  peekaboo:
    connections:
      peekaboo:
        approval:
          click: always
          type: always

Validate and run on the Mac:

assembly-line validate agent
assembly-line deploy agent --target local --serve

For a hosted agent controlling a paired Mac, use @assemblyline-agents/computer-use instead of exposing Peekaboo over the public internet.

License

MIT