$ bizs find "mandá los precios mayoristas nuevos a nuestros 38 clientes"sales.send_price_list escritura · necesita el OK del dueño customers*, note*
Instalación
Una línea, en macOS y Linux.
$ curl -fsSL bizs.sh/install | sh
Primeros pasos
Tres comandos para pasar de nada a un cambio registrado.
1
Iniciá sesión
Abre el navegador una vez y elegís el negocio en el que trabajás.
$ bizs loginSesión iniciada como ana@panaderiasur.com · negocio: Panadería Sur
2
Decí qué querés
Con tus palabras. find te responde con las operaciones que sirven, sus argumentos y un ejemplo.
$ bizs find "subí el precio de la harina de 25 kg a 31,20"
3
Ejecutalo
Cada cambio lleva un motivo, y queda registrado con quién y cuándo.
$ bizs run catalog.update_price --json '{"sku":"flour-25","price":31.2}' --reason "La harina subió 6%"{"ok":true,"sku":"flour-25","price":31.2,"record":"rec_9c41"}
Ejemplos
Lo que ve una sesión: respuestas cortas, la forma de la llamada que necesita, y JSON de salida.
find responde con la llamada
La operación, para qué sirve, sus argumentos obligatorios y un ejemplo listo.
$ bizs find "agregá una nota a Ana Ruiz: prefiere WhatsApp"crm.add_note escritura record_id*, body* una nota en un contacto, una organización o una oportunidad ejemplo: bizs run crm.add_note --json '{"record_id":"rec_8f2","body":"Prefiere WhatsApp"}' --reason "Lo pidió en la llamada"
find avisa cuando no está seguro
Si un pedido puede ir a más de un lugar, lo dice y da cada opción en vez de adivinar.
$ bizs find "la competencia en Bariloche bajó los precios 10%"ambiguo (0,48): elegí según de qué trata el pedido, o preguntá crm.add_note una nota en un contacto, una organización o una oportunidad knowledge.add_entry un dato del mercado, en el cuaderno del negocio
Lecturas filtradas
El filtro y la selección de campos se hacen en el servidor, así una lista larga nunca inunda la sesión.
Los pasos corren en orden y se detienen en el primer error.
$ bizs run --reason "La harina subió 6%" --steps '[{"op":"catalog.update_price","args":{"sku":"flour-25","price":31.2}},{"op":"crm.add_note","args":{"record_id":"rec_8f2","body":"Precios mayoristas nuevos desde el lunes"}}]'[{"step":1,"ok":true},{"step":2,"ok":true}]
Salida en JSON, así jq funciona
Cada respuesta es JSON. Pasala por un pipe.
$ bizs run sales.list_orders --grep 2026-11-17 --fields total | jq 'map(.total) | add'1240
Cómo funciona para agentes
El comando está pensado según lo que los agentes hacen de verdad con él, y se prueba con sesiones reales antes de cada versión.
Las palabras de la persona, tal cual
La guía le pide al agente que le pase el pedido a find exactamente como lo dijo la persona. Reformularlo es la forma de terminar en el sistema equivocado.
Ambiguo quiere decir preguntar
Si find responde ambiguo, el agente elige según de qué trata el pedido, o pregunta. Nunca una adivinanza reportada como hecha.
Filtrado en el servidor
--grep, --fields y --limit se aplican antes de que algo llegue a la sesión, sobre todas las páginas de resultados.
Ninguna clave en la sesión
Dentro de tu fábrica, los agentes no tienen ninguna credencial: la fábrica agrega quién actúa, y en nombre de quién, en su borde.
Un motivo en cada cambio
Cada cambio queda guardado con quién lo hizo, cuándo y por qué, para poder rastrearlo, deshacerlo o mejorarlo después.
Pregunta antes de lo importante
Lo que cuesta plata, sale del negocio o no se puede deshacer espera el OK del dueño, también desde la terminal.
Primeras pruebas internas En las mismas tareas, un agente usó más o menos la mitad de los tokens de entrada y la mitad del costo con esta línea de comandos que con un servidor MCP común (76 mil contra 149 mil tokens). Casi toda la ganancia vino de la forma de las respuestas, así que el servidor MCP de más abajo ofrece esa misma forma.
Iniciar sesión
Las personas inician sesión con el navegador. Los agentes y scripts fuera de tu fábrica usan un token.
Personas
bizs login abre tu navegador una vez. Elegís el negocio y el comando lo recuerda.
$ bizs login
Agentes y scripts
Un token limitado a un negocio y a un rol, creado en tu fábrica y revocable desde ahí. Dentro de la fábrica no hace falta.
$ export BIZS_TOKEN=bz_live_…$ bizs find "presupuestos abiertos de esta semana"
Configurar tu agente
Dale a tu agente la guía corta, como instrucciones, como skill o como servidor MCP.
AGENTS.md
La guía es corta a propósito: qué ejecutar, para qué sirve cada operación común y cuándo preguntar.
$ bizs guide >> AGENTS.md
Una skill
La misma guía, empaquetada como skill que tu agente carga cuando la necesita.
$ bizs guide --skill > skills/bizs/SKILL.md
MCP
Para las plataformas que prefieren MCP: los mismos find, describe y run, por stdio.
Mostrar la guía para agentes, como texto o como skill.
bizs find "<pedido>"
Las operaciones que sirven para un pedido, con argumentos y un ejemplo; ambiguo con opciones.
bizs describe <op>
Una operación: para qué sirve, sus argumentos y un ejemplo.
bizs run <op> [--json '<obj>'] [k=v …]
Ejecutar una operación. Salida en JSON.
--grep <texto> --fields a,b --limit n
Filtrar y elegir campos de una lectura en el servidor.
--steps '<json>'
Varios cambios en una llamada, en orden; se detiene en el primer error.
--reason "<por qué>"
Obligatorio en cada cambio; queda en el registro.
bizs mcp
Lo mismo, como servidor MCP por stdio.
Códigos de salida
Código
Significado
0
Hecho.
1
La operación falló; el error, con la forma de la llamada, en stderr.
2
Uso incorrecto: una opción o un argumento desconocido.
3
Espera aprobación: hace falta el OK del dueño, y el pedido está en su lista.
4
Sin sesión iniciada, o el token no puede hacer esto.
Novedades
Qué cambió, lo más nuevo primero.
v0.1
Primera versión
login, guide, find, describe y run; lecturas filtradas con --grep, --fields y --limit; varios cambios con --steps; un motivo en cada cambio; la guía como texto o como skill; lo mismo por MCP.