Referencia de comandos CLI

Opciones globalesEstas opciones se pueden usar con cualquier comando tier0 .

--jsonGenera JSON sin procesar--debugMuestra detalles de solicitud/respuesta HTTP

Operaciones básicas

tier0 doctorDiagnostica la conexión y autenticación local del CLI de Tier0

Uso

tier0 doctor

Notas

• Comprueba la configuración local, la conectividad OpenAPI, la presencia de API key y la identidad de la API key.

Ejemplo

tier0 doctor

tier0 configVer o actualizar configuración

Uso

tier0 config

Opciones

--base-url

Configurar la base URL de la plataforma

--api-key

Configurar la API key (alternativa a tier0 login)

--lang

Flag de compatibilidad obsoleto; la salida del CLI solo está en inglésobsoleto

Ejemplos

tier0 config

tier0 config --base-url https://tier0.dev

tier0 config --api-key sk-per-xxxxxx

tier0 loginAutenticarse mediante Device Flow

Uso

tier0 login

Opciones

--no-wait

Imprime la URL de autorización y sale sin sondeo

--setup-code

Sondea un setup code existente en lugar de crear uno nuevo

--base-url

Sobrescribir la base URL de la plataforma

Notas

• Sin --no-wait, el CLI consulta cada 5 segundos durante un máximo de 10 minutos.
• Con --no-wait --json, el CLI devuelve verification_url, setup_code y expires_in.

Ejemplos

tier0 login

tier0 login --no-wait --json

tier0 login --setup-code <setup_code>

tier0 apiLlamar directamente a un API endpoint

Uso

tier0 api <endpoint>

Opciones

--body

Cadena JSON del cuerpo de la solicitud

--body-file

Leer el cuerpo de la solicitud desde un archivo

--method

Método HTTP (GET|POST|PUT|DELETE)predeterminado: POST

--dry-run

Previsualizar la solicitud sin ejecutarla

Notas

• --body y --body-file son mutuamente excluyentes.

Ejemplos

tier0 api /openapi/v1/uns/browse --body '{"path":"/"}'

tier0 api /openapi/v1/uns/read --body '{"topics":["demo"]}'

tier0 api /openapi/v1/uns/write --body-file body.json

tier0 upgradeActualizar el CLI a la última versión

Uso

tier0 upgrade

Opciones

--dry-run

Comprobar actualizaciones sin instalar

-v, --version

Actualizar a una versión específica (predeterminado: latest)

Ejemplos

tier0 upgrade

tier0 upgrade --dry-run

tier0 uninstallDesinstalar tier0 CLI

Uso

tier0 uninstall

Opciones

--purge

Eliminar también el archivo de configuración (credenciales)

--remove-skills

Eliminar también la Tier0 Skill de los AI agents detectados

--keep-skills

Conservar agent skills (obsoleto; ahora es el comportamiento predeterminado)obsoleto

Notas

• Las Agent Skills y la configuración se conservan de forma predeterminada.
• El directorio local de skills integradas se elimina durante la desinstalación del CLI.

Ejemplos

tier0 uninstall

tier0 uninstall --purge

tier0 uninstall --remove-skills

tier0 uninstall --purge --remove-skills

tier0 versionMostrar versión

Uso

tier0 version

Ejemplo

tier0 version

Skills

tier0 skills installInstalar o reparar la Skill integrada en este CLI

Uso

tier0 skills install

Opciones

--force

Reemplazar la Skill activa con la línea base integrada

--no-sync

Instalar localmente sin sincronizar con los AI agents detectados

Ejemplos

tier0 skills install

tier0 skills install --force

tier0 skills listListar skills instaladasalias: ls

Uso

tier0 skills list

Ejemplo

tier0 skills list

tier0 skills updateActualizar skills a la última versiónalias: upgrade

Uso

tier0 skills update

Opciones

--dry-run

Comprobar actualizaciones sin instalar

Ejemplos

tier0 skills update

tier0 skills update --dry-run

tier0 skills versionMostrar información de versión de las skillsalias: ver

Uso

tier0 skills version

Ejemplo

tier0 skills version

tier0 skills statusMostrar el estado de la Skill activa e integrada

Uso

tier0 skills status

Ejemplo

tier0 skills status

tier0 skills syncSincronizar la Skill activa con los AI agents detectados

Uso

tier0 skills sync

Ejemplo

tier0 skills sync

Autenticación

tier0 auth whoamiMostrar la identidad de la API key actual

Uso

tier0 auth whoami

Notas

• Muestra usuario, workspace, nombre de key, tipo de key, roles y permisos.

Ejemplos

tier0 auth whoami

tier0 auth whoami --json

UNS

tier0 uns browseExplorar el árbol de namespace de UNS

Uso

tier0 uns browse

Opciones

-p, --path

Ruta para explorar en el árbol UNSpredeterminado: /

-d, --max-depth

Profundidad máxima de recursión (0 = ilimitado)predeterminado: 1

--include-metadata

Incluir metadatos del nodo

--include-leaf-value

Incluir valores de nodos hoja

Ejemplos

tier0 uns browse

tier0 uns browse --path /devices

tier0 uns browse --path / --max-depth 2

tier0 uns searchBuscar topics de UNS

Uso

tier0 uns search

Opciones

-k, --keyword

Buscar por palabra clave de nombre

--path-prefix

Filtrar por prefijo de rutapredeterminado: /

--topic-type

Filtrar por topic type

--page

Número de páginapredeterminado: 1

-l, --size

Tamaño de página (resultados máximos)predeterminado: 20

--include-metadata

Incluir metadatos del nodo

--include-leaf-value

Incluir valores de nodos hoja

Ejemplos

tier0 uns search --keyword temp

tier0 uns search --path-prefix /devices --size 50

tier0 uns search --keyword temp --include-metadata

tier0 uns readLeer el valor actual de topics de UNS

Uso

tier0 uns read [topic...]

tier0 uns read --topic <topic>

Opciones

-t, --topic

Nombre(s) de topic para leer (repetible; también se aceptan argumentos posicionales)repetible

--include-metadata

Incluir metadatos del topic (topicType, fields, description)

--include-leaf-value

Incluir valores de nodos hoja

Notas

• Se requiere al menos un topic mediante argumentos posicionales o --topic.

Ejemplos

tier0 uns read demo

tier0 uns read --topic demo

tier0 uns read temp humidity

tier0 uns read --topic sensor1 --include-metadata

tier0 uns writeEscribir un valor en un topic de UNS

Uso

tier0 uns write

Opciones

-t, --topic

Nombre del topic en el que escribir (obligatorio)obligatorio

-v, --value

Cadena de valor JSON (mutuamente excluyente con --file)

-f, --file

Leer valor desde archivo (mutuamente excluyente con --value)

--qos

Nivel MQTT QoS (0/1/2)predeterminado: 0

--retain

Configurar flag retain de MQTT

--dry-run

Previsualizar la solicitud sin ejecutarla

Notas

• --value y --file son mutuamente excluyentes.
• El valor debe ser un JSON object válido que coincida con los topic fields.

Ejemplos

tier0 uns write --topic demo --value '{"temp":25}'

tier0 uns write --topic demo --file payload.json

tier0 uns write --topic sensor1 --value '{"on":true}' --qos 1 --retain

tier0 uns historyConsultar datos históricos de topics

Uso

tier0 uns history

Opciones

-t, --topic

Nombre(s) de topic (repetible, obligatorio)obligatoriorepetible

--start

Hora de inicio: relativa (-1h/-30m/-7d), ISO 8601 o 'now' (obligatorio)obligatorio

--end

Hora de fin: relativa, ISO 8601 o 'now' (predeterminado: now)predeterminado: now

--page

Número de páginapredeterminado: 1

-l, --size

Tamaño de página (máximo de puntos de datos)predeterminado: 100

--interval

Intervalo de agregación (por ejemplo, 1m, 1h, 1d)

--fn

Función de agregación (avg/max/min/sum/count)

--field

Nombre del campo de agregación

Ejemplos

tier0 uns history -t demo --start -1h

tier0 uns history -t demo --start -24h --end now --fn avg --interval 1h

tier0 uns history -t demo --start 2026-01-01T00:00:00Z --end 2026-01-02T00:00:00Z

tier0 uns createCrear nodos de namespace de UNS

Uso

tier0 uns create

Opciones

-t, --topic

Ruta del topic o nombre de hoja (obligatorio si no se usa --file)

--parent

Prefijo de ruta padre (opcional, se combina con --topic)

--type

Tipo de nodo: 'path' (carpeta) o 'topic' (punto de datos)

-d, --display-name

Nombre visible

--description

Descripción

--alias

Alias

-f, --file

Leer definición de namespace desde archivo JSON ({"namespace":[]} o un array directo)

--topic-type

Obsoleto: el topic type ahora se deriva de la ruta (carpeta Metric/Action/State antes de la hoja)obsoleto

--fields

Array JSON de schema fields

--fields-file

Leer array JSON de schema fields desde archivo

--dry-run

Previsualizar la solicitud sin ejecutarla

Notas

• Si no se usa --file, --topic y --type son obligatorios.
• --fields y --fields-file son mutuamente excluyentes.
• En nodos topic, el segmento inmediatamente anterior a la hoja debe ser Metric, Action o State.

Ejemplos

tier0 uns create --topic Plant/Line1/Metric/Temperature --type topic

tier0 uns create --parent Factory1/Line1/Station1 --topic Metric/ProductionCount --type topic

tier0 uns create --topic Plant/Line1 --type path --display-name 'Line 1'

tier0 uns create --file namespace.json

tier0 uns updateActualizar metadatos de topic UNS

Uso

tier0 uns update

Opciones

-p, --path

Ruta del topic a actualizar (obligatorio)obligatorio

-n, --name

Nuevo nombre

--alias

Nuevo alias

--description

Nueva descripción

--clear-description

Borrar la descripción sin depender de un argumento vacío del shell

-d, --display-name

Nuevo nombre visible

--extend-properties

JSON object de propiedades extendidas

--fields

Array JSON de schema fields

--fields-file

Leer array JSON de schema fields desde archivo

--update-mask

Campos a actualizar (repetible, por ejemplo name,description,fields)repetible

--dry-run

Previsualizar la solicitud sin ejecutarla

Notas

• --description y --clear-description son mutuamente excluyentes.
• --fields y --fields-file son mutuamente excluyentes.
• Se requiere al menos un campo para actualizar.

Ejemplos

tier0 uns update --path Plant/Line1/Metric/Temperature --display-name 'Line 1 Temp'

tier0 uns update --path Plant/Line1 --description 'Production line 1' --update-mask description

tier0 uns update --path Plant/Line1/Metric/Temperature --fields '[{"name":"temp","type":"float","unit":"C"}]' --update-mask fields

tier0 uns deleteEliminar nodo(s) UNS

Uso

tier0 uns delete

Opciones

-p, --path

Ruta(s) de nodo a eliminar (repetible, obligatorio)obligatoriorepetible

--hard

Borrado definitivo (irreversible)

-y, --yes

Confirmar operación de alto riesgo (obligatorio)obligatorio

--dry-run

Previsualizar la solicitud sin ejecutarla

Notas

• El borrado suave es el predeterminado y se puede restaurar.
• --hard es irreversible.
• Las operaciones de alto riesgo requieren --yes salvo que se use --dry-run.

Ejemplos

tier0 uns delete --path factory/line1/sensor/temp --yes

tier0 uns delete --path factory/line1/sensor/temp --path factory/line1/sensor/humi --yes

tier0 uns delete --path factory/line1/sensor/temp --hard --yes

tier0 uns restoreRestaurar topic desde el historial

Uso

tier0 uns restore

Opciones

-p, --path

Ruta del topic a restaurar (obligatorio)obligatorio

-y, --yes

Confirmar operación de alto riesgo (obligatorio)obligatorio

--dry-run

Previsualizar la solicitud sin ejecutarla

Notas

• Las operaciones de alto riesgo requieren --yes salvo que se use --dry-run.

Ejemplo

tier0 uns restore --path Plant/Line1/Metric/Temperature --yes

Flujo Node-RED

tier0 flow listListar flowsalias: ls

Uso

tier0 flow list

Opciones

-k, --keyword

Filtrar por palabra clave de nombre

-t, --type

Filtrar por tipo (SourceFlow/EventFlow)

--source

Mostrar solo SourceFlow

--event

Mostrar solo EventFlow

Notas

• --source y --event son mutuamente excluyentes.
• --type no puede combinarse con --source ni --event.

Ejemplos

tier0 flow list

tier0 flow list --source --json

tier0 flow getObtener detalles del flow

Uso

tier0 flow get --id <id>

tier0 flow get <id>

Opciones

--id

Flow IDpredeterminado: 0

Notas

• Se requiere un Flow ID positivo mediante --id o como argumento posicional.

Ejemplos

tier0 flow get --id 1 --json

tier0 flow get 1 --json

tier0 flow createCrear un nuevo flow

Uso

tier0 flow create

Opciones

-n, --name

Nombre del Flow (obligatorio)obligatorio

-t, --type

Tipo de Flow: SourceFlow | EventFlow (obligatorio)obligatorio

--source

Definir tipo como SourceFlow

--event

Definir tipo como EventFlow

--desc

Descripción

--template

Cadena JSON de plantilla inicial

--template-file

Leer plantilla inicial desde archivo

--dry-run

Previsualizar la solicitud sin ejecutarla

Notas

• Use exactamente uno de --type, --source o --event para seleccionar el tipo de Flow.
• --template y --template-file son mutuamente excluyentes.

Ejemplos

tier0 flow create --name "modbus-collector" --source --desc "Modbus TCP collector"

tier0 flow create --name "alert-handler" --event --desc "Temperature alarm processor"

tier0 flow updateActualizar metadatos del flow

Uso

tier0 flow update --id <id>

tier0 flow update <id>

Opciones

--id

Flow ID (obligatorio)predeterminado: 0

-n, --name

Nuevo nombre

--desc

Nueva descripción

--template

Nueva cadena JSON de plantilla

--template-file

Leer nueva plantilla desde archivo

--favorite

Marcar como favorito

--unfavorite

Quitar de favoritos

--dry-run

Previsualizar la solicitud sin ejecutarla

Notas

• Se requiere un Flow ID positivo mediante --id o como argumento posicional.
• --template y --template-file son mutuamente excluyentes.
• --favorite y --unfavorite son mutuamente excluyentes.
• Se requiere al menos un campo para actualizar.

Ejemplos

tier0 flow update --id 1 --name "line1-collector"

tier0 flow update --id 1 --favorite

tier0 flow dataObtener JSON del canvas de Node-RED

Uso

tier0 flow data --id <id>

tier0 flow data <id>

Opciones

--id

Flow IDpredeterminado: 0

-o, --out

Guardar salida en archivo

Notas

• Se requiere un Flow ID positivo mediante --id o como argumento posicional.

Ejemplo

tier0 flow data --id 1 --out flows.json

tier0 flow deployDesplegar JSON del canvas de Node-RED

Uso

tier0 flow deploy --id <id>

tier0 flow deploy <id>

Opciones

--id

Flow ID (obligatorio)predeterminado: 0

--flows-json

Cadena JSON del canvas de Node-RED

-f, --flows-file

Leer JSON del canvas de Node-RED desde archivo (recomendado)

-y, --yes

Confirmar operación de alto riesgo (obligatorio)obligatorio

--dry-run

Previsualizar la solicitud sin ejecutarla

Notas

• Se requiere un Flow ID positivo mediante --id o como argumento posicional.
• --flows-json y --flows-file son mutuamente excluyentes.
• El despliegue reemplaza todos los nodos Node-RED existentes en el Flow.
• Las operaciones de alto riesgo requieren --yes salvo que se use --dry-run.

Ejemplos

tier0 flow deploy --id 1 -f flows.json --dry-run --json

tier0 flow deploy --id 1 -f flows.json --yes

tier0 flow deleteEliminar flow(s)alias: del, rm

Uso

tier0 flow delete --id <id>

tier0 flow delete <id>[,<id>...]

Opciones

--id

Flow ID(s) a eliminar (repetible)repetible

-y, --yes

Confirmar operación de alto riesgo (obligatorio)obligatorio

--dry-run

Previsualizar la solicitud sin ejecutarla

Notas

• Los argumentos posicionales pueden contener Flow IDs separados por comas.
• La eliminación detiene los contenedores Node-RED y no se puede deshacer.
• Las operaciones de alto riesgo requieren --yes salvo que se use --dry-run.

Ejemplo

tier0 flow delete --id 1 --yes

tier0 flow nodesListar tipos de nodos Node-RED disponibles

Uso

tier0 flow nodes [source|event]

tier0 flow nodes --type <SourceFlow|EventFlow>

tier0 flow nodes --source

tier0 flow nodes --event

Opciones

-t, --type

Tipo de Flow (SourceFlow/EventFlow)

--source

Mostrar nodos SourceFlow

--event

Mostrar nodos EventFlow

Notas

• Acepta como máximo un tipo de Flow posicional.
• --source y --event son mutuamente excluyentes.
• No combine entrada posicional/de tipo con --source o --event.

Ejemplos

tier0 flow nodes source --json

tier0 flow nodes --source --json

tier0 flow nodes --event --json

Archivos

tier0 assets uploadSubir un archivo a Tier0 object storage

Uso

tier0 assets upload <local-file>

Opciones

--business

Escena de negociopredeterminado: attachment

--use-by

Ámbito de uso: user|workspace|platformpredeterminado: workspace

--visibility

Visibilidad: public|privatepredeterminado: private

--app-instance-id

ID de instancia de app AI

--session-id

ID de sesión AI

--multipart-size

Tamaño de parte multipart (por ejemplo 10MB, mínimo 5MB)predeterminado: CLI-defined default

--concurrency

Concurrencia de carga multipart (número de partes paralelas)predeterminado: 4

--resume

Reanudar una carga multipart interrumpida

--abort

Cancelar una carga multipart interrumpida y limpiar su estado

Notas

• Se requiere exactamente un argumento de archivo local.
• Los archivos mayores de 100MB usan automáticamente carga multipart.
• El CLI no impone un tamaño máximo estricto; el servidor aplica límites de plan/cuota.

Ejemplos

tier0 assets upload ./report.csv

tier0 assets upload ./report.csv --visibility public --business attachment

tier0 assets upload ./report.csv --use-by workspace --visibility private

tier0 assets upload ./large-backup.tar.gz

tier0 assets upload ./large-backup.tar.gz --resume

tier0 assets upload ./large-backup.tar.gz --abort

tier0 assets upload ./large-backup.tar.gz --multipart-size 20MB --concurrency 8

tier0 assets downloadDescargar un archivo desde Tier0 object storage

Uso

tier0 assets download

Opciones

--file-path

Ruta de archivo devuelta por la cargaobligatorio

-o, --output

Ruta del archivo de salida (predeterminado: stdout)

--content-disposition

Content-Disposition personalizado

Ejemplos

tier0 assets download --file-path workspace/.../report.csv -o ./report.csv

tier0 assets download --file-path workspace/.../report.csv

tier0 assets urlObtener la URL de acceso del archivo en Tier0 object storage

Uso

tier0 assets url

Opciones

--file-path

Ruta de archivo devuelta por la cargaobligatorio

--expired-sec

Segundos de expiración de la URL prefirmadapredeterminado: 3600

--content-disposition

Content-Disposition personalizado

Ejemplos

tier0 assets url --file-path workspace/.../report.csv

tier0 assets url --file-path workspace/.../report.csv --expired-sec 300

tier0 assets deleteEliminar un archivo de Tier0 object storage

Uso

tier0 assets delete

Opciones

--file-path

Ruta de archivo devuelta por la cargaobligatorio

-y, --yes

Confirmar operación de alto riesgo (obligatorio)obligatorio

--dry-run

Previsualizar la solicitud sin ejecutarla

Notas

• La eliminación no se puede deshacer.
• Las operaciones de alto riesgo requieren --yes salvo que se use --dry-run.

Ejemplos

tier0 assets delete --file-path workspace/.../report.csv --dry-run --json

tier0 assets delete --file-path workspace/.../report.csv --yes