Instala el CLI de Ploybot en un minuto

La consola de Ploybot sirve para casi todo, pero hay cosas que se hacen mejor desde la terminal: dejar Claude Code o Codex conectado a un agente, llamar a una tool para probarla, aprobar lo pendiente sin abrir el navegador o dar de alta una API en un script. Para eso está ploybot, el CLI.

Qué necesitas

Un sistema de 64 bits: macOS (Apple Silicon o Intel), Linux (x86-64 o ARM64) o Windows (x86-64). Es un único ejecutable: no necesita Node, ni npm, ni instalar dependencias.

Instalar

En macOS y Linux, el mismo comando en cualquier máquina:

curl -fsSL https://app.ploybot.com/console/instalar/install.sh | sh

En Windows, desde PowerShell:

irm https://app.ploybot.com/console/instalar/install.ps1 | iex

El instalador elige el ejecutable de tu sistema y arquitectura, comprueba su huella SHA-256 contra el manifiesto publicado por el servicio y lo deja en tu directorio de usuario: ~/.local/bin en macOS y Linux, ~\bin en Windows (y lo añade a tu PATH). Si prefieres leer el script antes de ejecutarlo, abre su URL en el navegador. Y si no quieres ejecutar un script descargado, la página de instalación tiene también los comandos a mano para cada plataforma.

Comprueba que responde:

ploybot --version

Si dice que no encuentra el comando, añade ~/.local/bin a tu PATH.

Apuntar a tu cuenta

Una sola vez:

ploybot perfil authority https://app.ploybot.com

El emisor de identidad lo anuncia el propio servicio, así que no hace falta escribirlo. El perfil se guarda en ~/.agent-authority/config.json y solo lo puede leer tu usuario.

Conectar tu herramienta

ploybot install oauth <agentId>

Se abre el navegador, te identificas con tu passkey o tu contraseña, y el CLI deja el MCP de ese agente en Claude Code, Codex u OpenCode, según la receta del agente. El agentId lo tienes en Mis agentes, en la consola.

Para Cursor o Claude Desktop no hace falta el CLI: basta con copiar la URL del MCP desde Mis agentes.

Lo que usarás a diario

ploybot tools <agentId>            # las tools que ve ese agente
ploybot call <tool> --arg=valor    # llamar a una de ellas
ploybot pendientes                 # lo que espera tu decisión
ploybot uso --dias=30              # acciones e importe del último mes

ploybot call pregunta al servidor qué tools hay y valida los argumentos contra su esquema, así que una operación nueva no obliga a actualizar el CLI. Y su código de salida distingue una operación ejecutada de una que espera aprobación, que es lo que necesita un script.

Pensado para no filtrar secretos

• Toda salida con credencial no sigue redirecciones y tiene un techo de tamaño.
• La clave del dispositivo vive en el Llavero de macOS o en el almacén de secretos de Linux; el perfil solo guarda una referencia.
• Los secretos se pasan como env://VARIABLE. Si escribes uno literal en la línea de comandos, el CLI te avisa: quedaría en el historial y a la vista de ps.

Idioma, actualizar y desinstalar

El CLI habla castellano e inglés. Toma el idioma de PLOYBOT_LANG o del de tu terminal; los comandos y la salida --json no cambian.

Para actualizar, vuelve a ejecutar el comando de la página. Para desinstalar, basta con borrar el ejecutable (rm ~/.local/bin/ploybot); tu perfil se queda en ~/.agent-authority hasta que lo borres tú.