bizs Instalar
Línea de comandos

Tu fábrica, desde la terminal.

bizs es un solo comando para todo lo que puede hacer tu equipo. Hecho primero para agentes, e igual de claro para las personas que trabajan con ellos.

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 login
    Sesió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.

bizs run sales.list_orders --grep pendiente --fields id,customer,total --limit 3
[{"id":"ord_311","customer":"Café Norte","total":420},
 {"id":"ord_318","customer":"Hotel Lago","total":1180},
 {"id":"ord_322","customer":"Kiosco 9","total":96}]

Varios cambios, una llamada

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.

{"mcpServers":{"bizs":{"command":"bizs","args":["mcp"]}}}

Referencia de comandos

Todos los comandos y opciones.

ComandoQué hace
bizs loginIniciar sesión como persona y elegir el negocio.
bizs guide [--skill]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 nFiltrar 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 mcpLo mismo, como servidor MCP por stdio.

Códigos de salida

CódigoSignificado
0Hecho.
1La operación falló; el error, con la forma de la llamada, en stderr.
2Uso incorrecto: una opción o un argumento desconocido.
3Espera aprobación: hace falta el OK del dueño, y el pedido está en su lista.
4Sin sesión iniciada, o el token no puede hacer esto.

Novedades

Qué cambió, lo más nuevo primero.

  1. 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.