Desarrolladores

API · MCP · CLI

La terminal: el CLI tuasistente

Tu agente puede consultar tu negocio y, si le das permiso, cambiar tu inventario y tus pedidos sin pedirte aprobación. Lo que cuesta plata o les llega a tus clientes, como guías, cobros, facturas y mensajes, no se hace con la llave: sigue en el panel. No tiene costo mientras no publiquemos un precio en Precios.

El CLI tuasistente consulta tu negocio desde la terminal y sirve para ti, para tus scripts y para tus agentes. Es un cliente de la misma API y, por ahora, solo consulta: no cambia nada en tu negocio. Para cambiar tu inventario o tus pedidos, usa la API o el MCP.

Instalación

El CLI está en PyPI con el nombre tuasistente. Necesitas Python 3.11 o más reciente y uv (o pipx install tuasistente, si prefieres pipx):

terminal
uv tool install tuasistente
tuasistente --version

Para actualizar a la versión más reciente (con pipx, pipx upgrade tuasistente):

terminal
uv tool upgrade tuasistente

Iniciar sesión

Pega tu llave cuando el CLI te la pida; no se muestra en pantalla:

terminal
tuasistente login --llave

El CLI revisa la llave con la API y la guarda en el llavero del sistema; si no hay llavero, en un archivo que solo tu usuario puede leer. Nunca escribas la llave en el comando (--llave ta_pk_…): quedaría en el historial de la terminal, y el CLI lo rechaza. En automatizaciones, pásala por la entrada estándar o deja la llave en la variable TUASISTENTE_LLAVE, que gana sobre la guardada:

terminal
printf %s "$TUASISTENTE_LLAVE" | tuasistente login --llave -
tuasistente estado

Varios negocios: perfiles

Cada llave es de un negocio. Usa un perfil por negocio con --perfil (o con la variable TUASISTENTE_PERFIL). El primer perfil con el que inicias sesión queda como predeterminado.

terminal
tuasistente login --llave --perfil mi-tienda
tuasistente pedidos listar --perfil mi-tienda

tuasistente logout borra la llave guardada en ese equipo, pero la llave sigue activa hasta que venza o la revoques en el panel.

Comandos

  • tuasistente estado: negocio, rol, permisos, vencimiento de la llave y operaciones disponibles.
  • tuasistente resumen [--periodo hoy|7d|30d|mes]: resumen de ventas del negocio.
  • tuasistente pedidos listar [--vista V] [--buscar T] [--limite N] [--todas]: pedidos.
  • tuasistente pedidos ver NÚMERO: un pedido.
  • tuasistente inventario ver [--buscar T] [--todas]: existencias por artículo.
  • tuasistente inventario movimientos [--codigo C] [--todas]: movimientos de inventario.
  • tuasistente catalogo [--estado activos|archivados|todos]: productos del catálogo.
  • tuasistente herramientas [operación]: las operaciones de la API, o el detalle de una.
  • tuasistente llamar <operación> [--param k=v …]: cualquier operación de la API por su nombre.

Todos aceptan --perfil, --json (el cuerpo de la API tal cual, estable para scripts) y --help. --todas sigue las páginas hasta 20. Como tuasistente llamar lee el catálogo de la API, una operación nueva funciona sin instalar otra versión del CLI.

Ejemplos

Algunas consultas, y una para un script que lista los números de los pedidos por despachar:

terminal
tuasistente resumen --periodo 7d
tuasistente pedidos listar --vista por_despachar --limite 10
tuasistente pedidos ver MI-1003
tuasistente inventario ver --buscar TELA --todas
tuasistente herramientas listar_pedidos
tuasistente llamar listar_pedidos --param vista=por_despachar --param limite=5

tuasistente pedidos listar --vista por_despachar --todas --json | jq '.items[].numero'

Códigos de salida

  • 0: todo bien.
  • 1: otro error (red, parámetros o una respuesta inesperada).
  • 3: sin permiso (403).
  • 4: límite de uso (429). El mensaje dice cuánto esperar; si son 5 segundos o menos, el CLI reintenta una vez.
  • 5: sin sesión, o la llave venció o fue revocada (401).
  • 6: no disponible (404).