Herramienta de línea de comandos de TinyShield (tinyshield-cli)
tinyshield-cli controla TinyShield desde Terminal y desde tus propios scripts. Ofrece las mismas herramientas que el servidor MCP. Por ejemplo, un script de compilación puede aprobar las herramientas que ejecuta, y una tarea de cron puede exportar tus reglas.
La línea de comandos es una función de TinyShield PRO. Actívala junto con el servidor MCP en TinyShield › Settings › MCP.
1. Configurarla
La herramienta está dentro de la app:
"/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-cli" --help
Agrega un alias al perfil de tu shell (~/.zshrc), como se muestra en Settings › MCP:
alias tinyshield='"/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-cli"'
En la edición de Setapp, usa /Applications/Setapp/Tiny Shield.app. Si TinyShield no está abierto, el comando lo abre primero en segundo plano.
2. Comandos
| Comando | Qué hace |
|---|---|
tinyshield status | Versión, licencia, modo de conexión, Network Extension y número de reglas |
tinyshield mode [allow-all|require-approval|block-all] | Muestra o cambia el modo de conexión |
tinyshield pending list | Apps que esperan aprobación y a dónde intentaron conectarse |
tinyshield pending allow <app>… / block <app>… | Permite o bloquea apps en espera por nombre, bundle ID, ruta, pid o ID (--all para todas) |
tinyshield pending wait [--timeout 60] | Espera hasta que una app necesite aprobación |
tinyshield decisions [list|allow|block|remove] | Las App Connection Decisions del modo Require Approval |
tinyshield block-list [list|add|remove|enable|disable] | La Block List |
tinyshield allow-list [list|add|remove] | La Allow List |
tinyshield apps [--range 1h] [--status blocked] | Apps que usaron la red |
tinyshield app <app> o --pid <pid> | Una app: firma, reglas, actividad y ancho de banda |
tinyshield connections <app> o --pid <pid> | Los dominios y direcciones IP a los que se conectó una app |
tinyshield domain <domain> / tinyshield ip <ip> | Quién se conectó a un dominio o una IP, y las reglas que coinciden |
tinyshield tree | La lista de la ventana principal, en forma de árbol |
tinyshield countries | Los países a los que se conectaron las apps, como en el mapa |
tinyshield recently-blocked [--clear] | Las últimas conexiones bloqueadas |
tinyshield bandwidth [--timeframe day] [--app Safari] / tinyshield live | Uso de datos y velocidad actual |
tinyshield settings [get|set <setting> on|off] | Ajustes como block-list, dns, apple-programs o launch-at-login |
tinyshield export <file> / tinyshield import <file> [--replace] | Guarda o carga tu configuración |
tinyshield open <window> [--search text] | Muestra una ventana de TinyShield, por ejemplo main, block_list o mcp_settings |
tinyshield clear-activity --yes | Elimina la actividad de red registrada (las reglas se conservan) |
tinyshield tools / tinyshield call <tool> '<json>' | Lista todas las herramientas o llama a una con argumentos JSON |
Ejecuta tinyshield <command> --help para ver todas las opciones.
En block-list add y allow-list add, un valor que empieza por /, ~ o ./ es una app o un ejecutable. Cualquier otro es un dominio, un comodín (*.example.com) o una dirección IP.
3. Ejemplos
Aprueba el gestor de paquetes que usa una compilación y luego ejecuta la compilación:
tinyshield pending allow ~/.local/bin/uv
uv pip install -r requirements.txt
Aprueba herramientas por adelantado antes de una tarea larga y desatendida:
tinyshield allow-list add /opt/homebrew/bin/node ~/.local/bin/uv
Avisa a alguien cuando una app necesite aprobación:
if tinyshield pending wait --timeout 600 --only-new; then
osascript -e 'display notification "An app is waiting for approval" with title "TinyShield"'
fi
Bloquea un rastreador en todas partes y revisa quién se conectó a él:
tinyshield block-list add '*.doubleclick.net'
tinyshield domain doubleclick.net --subdomains --range 7d
4. Scripts
- Agrega
--jsona cualquier comando para obtener una salida legible por máquinas. - Agrega
--no-launchpara que falle en lugar de abrir TinyShield. - Códigos de salida:
| Código | Significado |
|---|---|
0 | Éxito |
1 | El comando falló. pending wait también sale con 1 cuando TinyShield no está en modo Require Approval |
3 | No encontrado. pending wait también sale con 3 cuando nada pidió aprobación antes del tiempo límite |
4 | Se necesita TinyShield PRO |
69 | No se puede contactar con TinyShield: el servidor está desactivado, o TinyShield no está instalado o no está abierto (con --no-launch) |
Las decisiones tomadas desde la línea de comandos aparecen como Command Line en la lista Decisions de TinyShield.