convez.ai
MCP ServerAutomaçãoIntermediário
mkusaka

pbm - Automação macOS Determinística

mkusaka/pbm

Automação macOS nativa com MCP para Claude e agentes de IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP e CLI nativo em Swift para automação de desktop macOS com contrato JSON estável e determinístico. Permite capturar estado da tela, clicar em elementos, gerenciar janelas e aplicativos, tudo sem chamar modelos de IA ou shell execution. Ideal para integração com Claude e outros agentes que precisam de controle preciso do macOS.

Instalação

$npx convez-ai mkusaka/pbm

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 dia
Versão
v0.0.1
Issues abertas
2
Contribuidores
2

Casos de uso

  • Integrar automação de desktop com Claude via MCP stdio
  • Capturar screenshots e elementos da tela para análise visual
  • Automatizar cliques e interações em aplicativos macOS de forma determinística
  • Construir workflows de teste e validação de UI em macOS
  • Gerenciar janelas, aplicativos e clipboard programaticamente

Veredito

Ferramenta robusta e bem arquitetada para automação macOS em contextos de agentes Claude. Implementação nativa em Swift garante segurança e determinismo; foco em contrato JSON estável e confirmações explícitas para ações destrutivas demonstra design maduro. Recomendado para quem precisa de controle preciso de desktop macOS integrado a sistemas de IA.

README

A tradução para o português deste README ainda está na fila.

pbm

pbm is a deterministic macOS desktop automation CLI and MCP stdio server.

The macOS implementation is native Swift and returns the stable JSON contract:

{ "schemaVersion": "pbm.stable.v1", "ok": true, "data": {} }

Failures use the same envelope with structured error codes. Commands do not call AI models, agents, model providers, natural-language planners, shell execution tools, or remote public listeners.

Build

swift build
swift test
.build/debug/pbm --version
.build/debug/pbm doctor

Install the development binary wherever you want the public command name:

install -m 0755 .build/debug/pbm /usr/local/bin/pbm

Install

brew tap mkusaka/tap
brew install mkusaka/tap/pbm
pbm --version
pbm doctor

Examples

pbm doctor
pbm --version
pbm config init
pbm see
pbm see --bundle-id com.google.Chrome
pbm see --bundle-id com.google.Chrome --window-title Inbox --max-children 50 --timeout 5
pbm see --app-id com.google.Chrome
pbm see --scope allApps --max-elements 2000
pbm image --mode screen --path /tmp/pbm-screen.png
pbm click --target B1
pbm click --target-text "Send"
pbm window list
pbm app list
pbm clipboard get
pbm clipboard get --type public.png --output /tmp/clipboard.png
pbm snapshot list
pbm mcp

Documentation

Contract

Every CLI command writes one JSON envelope to stdout.

Success:

{
  "schemaVersion": "pbm.stable.v1",
  "ok": true,
  "data": {}
}

Failure:

{
  "schemaVersion": "pbm.stable.v1",
  "ok": false,
  "error": {
    "code": "target_not_found",
    "message": "Target was not found.",
    "details": {},
    "retryHint": "optional"
  }
}

Exit codes:

  • 0: success
  • 2: invalid arguments or required confirmation missing
  • 1: permission, target, platform, capability, or internal failure

Safety

The default config requires --confirm for destructive commands when safety.confirmDestructiveActions is true. This covers window close, app quit/relaunch, clipboard clear, dialog dismiss, daemon/Bridge uninstall, and disruptive Dock commands.

Tool policy applies to both CLI and MCP:

{
  "policy": {
    "allow": [],
    "deny": ["clipboard.clear"]
  }
}
Ver o original no GitHub

Bom para

Relacionados