Skip to main content

operx: OperX desde la terminal

operx usa la API de OperX con tu token personal: lo mismo que puedes hacer en la app, desde una terminal, un script o una tarea programada. Actúa como tú, con tu rol, y solo en tu empresa.

Instalar

Windows (PowerShell):

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"; uv tool install operx-cli

Mac y Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh && uv tool install operx-cli

uv instala su propio Python, así que no necesitas tener uno. Si ya tienes Python 3.10 o más nuevo, también sirve pipx install operx-cli. Abre una terminal nueva y comprueba con operx --version.

Para actualizar: operx update. La pantalla de bienvenida avisa cuando hay una versión nueva. En Windows la instala otra ventana, que espera a que se cierre operx (Windows no deja reemplazar un programa abierto); si quedó a medias, uv tool install operx-cli --force --refresh lo deja bien.

Entrar

operx login
  1. La terminal muestra un código y abre el navegador en la página de OperX.
  2. Entras como siempre. La página dice qué terminal pide acceso: apruébalo solo si acabas de escribir operx login en tu propio computador y el código es el mismo. Escribe el código de 6 dígitos de tu app de autenticación (o tu contraseña, si no usas una) y elige Solo lectura o Lectura y escritura.
  3. Vuelve a la terminal: ya entraste. Nunca ves ni copias un token.

Tu rol necesita el permiso «Acceso por API» (Ajustes › Usuarios y acceso › Roles); un administrador lo da. El acceso dura 90 días y lo ves, y puedes revocarlo, en el menú de tu cuenta › Acceso por API.

El token queda en el llavero del sistema (en Windows, el Administrador de credenciales; en Mac, el Llavero). En un equipo sin llavero, como un servidor Linux, queda en un archivo de la carpeta de operx que solo tú puedes leer (~/.config/operx/token-principal, permisos 600). En un servidor sin navegador: operx login --token te deja pegar un token creado en Acceso por API, o puedes usar variables de entorno: OPERX_TOKEN (el token) y, si no es producción, OPERX_DIRECCION.

Para otra dirección u otra empresa, usa un perfil:

operx --perfil pruebas login --direccion https://…
operx --perfil pruebas ordenes listar

operx logout cierra la sesión: revoca el token en el servidor y lo borra de este equipo. Un token puesto en OPERX_TOKEN no lo toca.

Modo interactivo

Escribe operx solo, en una terminal, y se abre la pantalla de bienvenida con un prompt: quién eres, un aviso si tu acceso vence en menos de una semana, y los números de hoy de cada producto de tu empresa (órdenes abiertas y vencidas, artículos bajo el mínimo, equipos parados, acciones del SG-SST, obligaciones ambientales del mes). Ahí escribes los comandos sin el operx, con Tab para completar y ↑ para repetir lo anterior:

operx › ordenes listar --vencidas
operx › buscar "bomba"
operx › ayuda
operx › salir

salir (o Ctrl+D) termina la sesión sin borrar tu token. ayuda y Tab muestran solo los comandos de los productos que tiene tu empresa. En un script o una tubería, operx solo muestra la ayuda y no espera a nadie.

Tab en PowerShell

operx completar hace que Tab complete los comandos y las opciones de operx también en tu PowerShell de siempre (operx ord + Tab → operx ordenes). Pregunta antes de agregar una línea a tu perfil de PowerShell, y operx completar --quitar la quita. No toca la política de ejecución: si tu PowerShell no corre scripts, te dice la línea para permitir los tuyos.

Comandos

operx buscar "bomba"                       # como la barra de búsqueda de la app

operx ordenes listar --estado en-progreso --asignada-a yo
operx ordenes ver 1234
operx ordenes crear --titulo "Cambio de rodamiento" --equipo BOM-04 --prioridad alta --vence 30/10/2026
operx ordenes estado 1234 completada         # no se deshace aquí: se reabre en la app
operx ordenes asignar 1234 "Pedro Pérez"
operx ordenes comentar 1234 "Llegó el repuesto"
operx ordenes editar 1234 --prioridad critica --vence 05/11/2026
operx ordenes adjuntar 1234 foto.jpg --momento despues
operx ordenes repuestos 1234                   # lo planeado, lo usado y su costo
operx ordenes repuesto 1234 --articulo FIL-010 --lugar "Bodega central" --cantidad 2

operx reportes indicadores --dias 30           # MTTR, MTBF, cumplimiento de preventivos
operx reportes vencidas
operx reportes carga                           # órdenes por persona
operx avisos                                   # tus avisos sin leer
operx agenda                                   # lo que toca esta semana

operx preventivos listar --estado vencidos
operx preventivos ver 12
operx preventivos crear --nombre "Lubricar rodamientos" --cada 3 --unidad meses --equipo BOM-04 --proxima 01/11/2026
operx preventivos nota 12 "Usar grasa EP2"
operx preventivos ejecuciones 12

operx equipos listar --buscar compresor
operx equipos ver BOM-04
operx equipos crear --nombre "Bomba 4" --codigo BOM-04 --lugar "Planta Norte"
operx equipos editar BOM-04 --estado en-mantenimiento --lugar "Taller"
operx clientes listar
operx clientes crear --nombre "Acme S.A.S." --nit 900123456
operx clientes crear --nombre "Filtros Ltda" --rol proveedor
operx clientes editar 900123456 --telefono "601 555 0101"
operx lugares listar
operx lugares crear --nombre "Bodega central" --tipo bodega --dentro-de "Planta Norte"

operx articulos listar --bajo-minimo
operx articulos ver FIL-010
operx articulos crear --nombre "Filtro de aceite" --unidad und --tipo consumible

operx inventario existencias --buscar filtro
operx inventario entrada --articulo FIL-010 --lugar "Bodega central" --cantidad 10 --costo-unitario 1.500,50
operx inventario salida --articulo FIL-010 --lugar "Bodega central" --cantidad 2 --motivo Consumo
operx inventario traslado --articulo FIL-010 --cantidad 2 --de "Bodega central" --a "Camioneta 1"
operx inventario ajuste --articulo FIL-010 --lugar "Bodega central" --cantidad -1 --motivo Conteo
operx inventario movimientos --articulo FIL-010
operx inventario revertir 4512                 # deshace un movimiento equivocado
operx inventario por-comprar                   # lo bajo el mínimo y las solicitudes aprobadas

operx equipos parar BOM-04 --motivo Falla --minutos 90
operx equipos reanudar 21
operx equipos hallazgo BOM-04 --titulo "Fuga en el sello" --severidad alta
operx equipos hallazgo-a-orden 8 --prioridad alta  # la orden para ese hallazgo
operx lecturas anular 31 --motivo "Lectura de otro equipo"

operx lecturas puntos BOM-04
operx lecturas registrar --punto 12 --valor 73,4

operx personas listar --buscar pérez
operx personas importar empleados.xlsx               # revisa el archivo, no guarda
operx personas importar empleados.xlsx --confirmar   # guarda si ninguna fila tiene errores
operx personas ausencia "Ana Ruiz" --tipo vacaciones --desde 02/11/2026 --hasta 06/11/2026
operx personas ausencia "Ana Ruiz" --tipo permiso --desde 09/11/2026 --horas 08:00-10:00

operx rutinas listar
operx rutinas crear "Contar la bodega" --rol Bodeguero      # sin --rol ni --persona, es para todos
operx rutinas crear "Revisar el taller" --dia lunes --dia jueves  # sin --dia, va todos los días
operx rutinas cambiar "Contar la bodega" --persona "Ana Ruiz"
operx rutinas cambiar "Revisar el taller" --todos-los-dias
operx rutinas quitar "Contar la bodega"                    # sale de los planes desde ahora
operx rutinas cumplimiento --mes 10/2026                    # quién hizo sus rutinas (administradores)

operx campos listar                                         # la información extra de las personas
operx campos crear "Hijos" --tipo numero
operx campos guardar "Ana Ruiz" --valor "Hijos=2" --valor "Fecha de nacimiento=17/05/1990"
operx campos ver "Ana Ruiz"
operx campos listar --de equipos                            # la información extra de los equipos
operx campos crear "Voltaje" --tipo numero --de equipos
operx campos guardar BOM-01 --valor "Voltaje=220" --de equipos
operx campos ver BOM-01 --de equipos

operx sst acciones --estado abiertas
operx sst nueva-accion --titulo "Señalizar la salida" --para 15/11/2026 --responsable "Ana Ruiz"
operx sst accion-hecha 7 --evidencia "Se instalaron dos señales"
operx sst incidentes

operx ambiental acciones
operx ambiental permisos
operx ambiental obligaciones --mes 11/2026
operx ambiental residuo --corriente "Aceite usado" --kg 12,5

operx muestreo campanas --estado en-campo
operx muestreo campana C-2026-001
operx muestreo relojes --horas 24                           # los frascos que vencen en 24 horas
operx muestreo informes --pendientes                        # lo que le falta a cada campaña

operx laboratorio hoy                                       # lo que pide atención hoy en el laboratorio
operx laboratorio cola --mia                                # los ensayos que esperan en el banco, con su reloj
operx laboratorio muestra M-000231                          # una muestra y sus ensayos
operx laboratorio lote LT-000045                            # sus filas, con el número que usa `valor`
operx laboratorio valor 72 --entrada lectura=0,412          # los primeros valores crudos de una fila
operx laboratorio lectura "Nevera 2" --valor 4,1            # la temperatura de una nevera
operx laboratorio verificar BA-01 --lectura "Pesa 100 g=100,002"
operx laboratorio vencimientos                              # calibraciones, verificaciones y patrones
operx laboratorio reactivos --dias 60                       # lotes y soluciones que vencen

operx chat canales                                          # tus canales, con lo que no has leído
operx chat leer mantenimiento                               # el nombre sin #: la terminal lee # como comentario
operx chat leer mantenimiento --hilo 123                    # las respuestas de un hilo
operx chat escribir mantenimiento "@Pedro Pérez la bomba 4 quedó lista"
operx chat para-mi
operx chat buscar rodamiento
operx chat leido mantenimiento

Chat va solo por canales: los mensajes directos, los grupos y los archivos son de la app.

operx iot dispositivos                                  # los que envían datos de las máquinas, y su estado
operx iot canales "Broker planta"                       # qué envía cada canal y a qué punto va
operx iot mensajes d-7f3k2m --cuantos 5                 # lo que llegó, tal cual
operx iot mapear d-7f3k2m planta/comp2/temp --equipo "Compresor 2" --punto "Temperatura rodamiento"
operx iot silenciar d-7f3k2m planta/comp2/temp --hasta "05/11/2026 18:00" --motivo "Mantenimiento"

Los indicadores de IoT (la pestaña Indicadores de la app):

operx iot estado --lugar "Planta Yumbo"                 # cada máquina por su punto peor ahora; --todas, también las que están bien
operx iot fuera-de-rango --dias 7                        # las máquinas con más tiempo fuera de rango
operx iot limite                                         # los puntos que se acercan a su límite, y en cuántos días
operx iot disponibilidad --bajo-95                       # cuánto llegó de lo que debía enviar cada dispositivo
operx iot horas --dias 30                                # horas de marcha por máquina, desde su horómetro
operx iot informe --mes octubre --lugar "Planta Yumbo"   # el informe del mes
operx iot informe --mes 2026-10 --pdf informe.pdf        # el mismo, en PDF

Comparar máquinas no tiene comando propio: operx api GET iot/indicators/compare/ -q days=7.

Las claves de los dispositivos se crean y se ven solo en la app, en la pestaña Clave del dispositivo: el CLI no las crea ni las muestra.

Reenviar desde un computador de la planta

operx iot forward corre en un computador de la planta, sin parar: lee el broker de la planta o una carpeta de archivos CSV y lo envía a OperX por HTTPS. Lo que no puede enviar queda en ese computador, en orden, hasta que vuelve internet.

operx iot forward "mqtt://localhost/planta/#"                   # el broker de la planta
operx iot forward "mqtts://broker.planta:8883/planta/#" --usuario lector --ca ca.crt
operx iot forward "C:\scada\exportes"                           # una carpeta de CSV
  • Usa la clave de un dispositivo, no tu sesión: créalo en la app, en Agregar dispositivo › «Computador de la planta» (hasta 300.000 valores al día). Ponla en la variable OPERX_DEVICE_KEY, o te la pide sin mostrarla; nunca va como opción. La clave del broker va en OPERX_BROKER_CLAVE.
  • Cada tema es un canal (planta/comp2/temp); en un JSON, cada clave va bajo su tema. De cada canal envía el primer valor de cada minuto.
  • Un CSV lleva una columna Fecha y una columna por canal, o Fecha, Canal y Valor. Lee lo nuevo de la carpeta cada 30 segundos.
  • Lo que espera queda en la carpeta de operx (o en el archivo de --datos), hasta 2 millones de valores. Cada minuto escribe una línea con lo leído, lo enviado y lo que espera.
  • Para que corra solo al prender el computador: el Programador de tareas de Windows o un servicio de systemd, con la clave en OPERX_DEVICE_KEY y lo que escribe guardado en un archivo. La guía «Desde un computador de la planta» de IoT lo explica paso a paso.

SG-SST y Ambiental van por empresa: sin --empresa, la de tu cuenta. Si llevas el SG-SST o lo ambiental de tus clientes, operx sst empresas y operx ambiental empresas las listan.

operx --help y operx ordenes --help muestran todas las opciones.

  • Los equipos, lugares, clientes, artículos y personas se nombran por su código o su nombre exacto. Si dos se llaman igual, operx lo dice y pide el id.
  • Los números y las fechas se escriben como en la app: 73,4, 1.500,50, 30/10/2026, 22/10/2026 08:00.
  • Las listas muestran la primera página; --todas las trae todas.
  • --json da todo lo que responde la API; --csv da un CSV que Excel abre bien (operx equipos listar --todas --csv > equipos.csv).

Antes de escribir

Todo lo que crea o cambia algo pregunta antes. En un script o una tarea programada no hay a quién preguntar: agrega --si. Con --json, lo que escribe responde el registro creado o cambiado (con su id) en vez de una frase. Cada escritura queda en el historial del token (Acceso por API › el token › Actividad) marcada como hecha desde la CLI.

Importar personas

La primera columna con el nombre basta. operx reconoce las columnas Nombres, Apellidos, Código, Cargo, Tipo de contrato, Fecha de ingreso, Fin de contrato, Celular, Sede y las de contacto de emergencia, con o sin tildes. Una columna con otro nombre se indica con --mapa "Tu columna=campo". Nadie recibe acceso a la app al importarlo: las invitaciones se envían en Usuarios y acceso.

Cualquier otra llamada

Lo que no tiene comando propio se hace con operx api: todo lo que tu token puede hacer, más de 400 llamadas. operx api rutas las lista (operx api rutas sst inspections deja las que tienen esas palabras), y operx api campos RUTA dice qué lleva una: sus filtros, cada campo con su tipo, si es obligatorio y los valores permitidos. También están en Acceso por API › Documentación:

operx api rutas purchase requests
operx api campos inventory/purchase-requests/ --metodo POST
operx api POST inventory/purchase-requests/ -d '{"item": 3, "quantity": "10", "reason": "Bajo el mínimo"}'
operx api GET pm/schedules/ -q search=compresor
operx api POST contacts/ -d @contacto.json
operx api GET work-orders/export/ -o ordenes.csv
operx api POST work-orders/1234/attachments/ -a file=foto.jpg -d '{"file_type": "photo"}'

En Git Bash, una dirección que empieza por / se vuelve una ruta de Windows: escríbela sin la barra inicial, como arriba.

Para agentes de IA

operx agentes imprime una guía para un agente de IA (Claude, ChatGPT, Copilot, Codex…): las reglas para usar operx bien (leer con --json, preguntar antes de escribir, no tocar tokens) y cada comando con sus opciones. Dile a tu agente: «Ejecuta operx agentes y sigue esa guía».

Para desarrollar

cd cli
python -m venv .venv && .venv/Scripts/python -m pip install -e ".[test]"
.venv/Scripts/python -m pytest

operx_cli/client.py es lo único que habla con la red; el servidor MCP lo usará igual.

Publicar una versión

El paquete es operx-cli en PyPI. Una versión publicada no se puede reemplazar: si algo falla, se sube la siguiente.

  1. Sube el número en pyproject.toml y en operx_cli/__init__.py.

  2. Las funciones nuevas del servidor (como operx login) tienen que estar ya desplegadas en producción antes de publicar: el paquete nuevo las llama.

  3. Desde cli/:

    uv build --clear
    uv publish
    

uv publish toma el token de PyPI de la variable de entorno UV_PUBLISH_TOKEN. Usa un token solo del proyecto operx-cli (PyPI › Account settings › API tokens). Se guarda una vez, en tu usuario de Windows, desde PowerShell; lo pegas donde lo pide y no se ve:

$token = Read-Host "Token de PyPI" -AsSecureString
[Environment]::SetEnvironmentVariable("UV_PUBLISH_TOKEN", [Net.NetworkCredential]::new("", $token).Password, "User")

Las terminales que abras después ya lo tienen. El token es secreto: nunca va en un archivo del repositorio ni en un chat.

Metadata

Release files for operx-cli 0.15.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for operx-cli 0.15.0
File Size Uploaded Provenance Actions
operx_cli-0.15.0.tar.gz 189.3 kB Without provenance Details for operx_cli-0.15.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for operx-cli 0.15.0
File Interpreter ABI Platform Actions
operx_cli-0.15.0-py3-none-any.whl Python 3 none any Details for operx_cli-0.15.0-py3-none-any.whl

Total release size: 332.4 kB

Release files / operx_cli-0.15.0.tar.gz

Download URL operx_cli-0.15.0.tar.gz
Size 189.3 kB
Tags Source
SHA-256 checksum
How to use checksums
c415c00bc875974bdf2447cebef1594d64efc20971a576ec33cc077d9cf4eaf3
BLAKE2b-256 checksum
How to use checksums
b39d21e4aa155634818ba2537cbe58908e479e2e07d821f23d1643dd0009fd1d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / operx_cli-0.15.0-py3-none-any.whl

Download URL operx_cli-0.15.0-py3-none-any.whl
Size 143.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
aa623abc109c2ae78a8866cd5d06dc5795dac87f89214a01046851989279f84a
BLAKE2b-256 checksum
How to use checksums
4dd2a7cd86432bf755af424aaac05c55be573a566f458d076b9eaea1cd38e630
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for operx-cli 0.15.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.15.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page