Guía de comandos

Cada comando de SMART, explicado.

Usa esta referencia para entender qué cambia un comando y copia la forma exacta que necesites.

Referencia de comandos

Los ejemplos de generación usan --dry-run para crear un plan revisable sin escribir. Sustitúyelo por --yes solo después de revisar los archivos planificados.

Comprobación del entorno

Valida el catálogo de generación integrado y cada plantilla registrada antes de generar un proyecto.

smart doctor
Catálogo de generación

Enumera las recetas de generación basadas en datos y sus identificadores.

smart catalog list

Muestra el propósito, los roles necesarios, los parámetros y la versión de una receta.

smart catalog describe service/edocument
Proyectos

Planifica un proyecto SOKit rc8 nuevo con identidad, paquete y topología de repositorio explícitos.

smart project init ./platform --id platform --name Platform --group com.example --base-package com.example.platform --topology monorepo --dry-run

Inspecciona un repositorio existente y planifica la configuración de SMART sin sustituir archivos de la aplicación.

smart project adopt . --dry-run

Lee la topología, la configuración, los componentes y las evidencias detectadas sin modificar el proyecto.

smart project inspect .

Comprueba la configuración y los archivos detectados, y muestra diagnósticos de validación accionables.

smart project validate .
Aplicaciones de UI

Planifica una aplicación SOKit UI 1.1.4 dentro del proyecto y la ubicación seleccionados.

smart app add ui portal --project . --dry-run
Servicios

Planifica un servicio de documentos electrónicos rc8 con sus módulos de datos y documentos.

smart service add edocument documents --project . --dry-run

Planifica el servicio de referencias rc8 único del proyecto y sus módulos de persistencia.

smart service add reference references --project . --dry-run

Planifica el servicio de almacenamiento rc8 único del proyecto con el controlador seleccionado.

smart service add bucket files --project . --dry-run

Planifica el servicio de notificaciones rc8 único del proyecto y sus controladores de entrega opcionales.

smart service add notifier notifications --project . --dry-run
Ámbitos de almacenamiento

Planifica un ámbito validado para un servicio de almacenamiento existente, incluidos almacenamiento, límites, tipos de medios y roles.

smart bucket scope add attachments --storage primary --project . --dry-run
Autenticación

Abre el inicio de sesión seguro en el navegador y guarda las credenciales de SMART resultantes para este perfil.

smart auth login

Muestra un QR local, una URL de verificación y un código corto, y espera mientras inicias sesión desde cualquier navegador.

smart auth login --device

Actualiza la sesión actual de SMART y carga de inmediato sus roles efectivos.

smart auth refresh

Muestra si el perfil actual ha iniciado sesión y qué identidad está usando.

smart auth status

Cierra la sesión de SMART y elimina las credenciales guardadas localmente para el perfil actual.

smart auth logout

Inicio de sesión del dispositivo, del terminal a SMART

Imágenes locales reales de un flujo completo de autorización de dispositivo con la CLI nativa compilada de SMART. Los formularios del código y de las credenciales se muestran como pasos distintos, pero se omite su introducción; no aparecen contraseñas, tokens ni credenciales reutilizables.

Leer la transcripción
  1. Ejecuta smart auth login --device; SMART muestra en el terminal un código QR local, una URL de verificación y un código corto de un solo uso.
  2. El formulario real Device Login de Keycloak muestra dónde introducir el código de un solo uso; el campo permanece vacío en la grabación.
  3. Después de enviar el código, Keycloak solicita un nombre de usuario y una contraseña; la introducción de credenciales se omite deliberadamente.
  4. Keycloak confirma Device Login Successful en esa misma sesión completada.
  5. La misma sesión de la CLI nativa de SMART muestra Signed in to SMART y confirma los roles skills:sokit y tools:sokit.
Servicio SMART local

Inicia el servicio MCP local de SMART para el perfil que ha iniciado sesión.

smart mcp start

Muestra si el servicio MCP local de SMART se está ejecutando y cómo pueden acceder los clientes.

smart mcp status

Detiene el servicio MCP local de SMART sin eliminar las integraciones de agentes.

smart mcp stop
Integraciones de agentes

Conecta Codex al servicio MCP local de SMART sin alterar la configuración no relacionada.

smart mcp integrate codex on

Elimina únicamente las entradas administradas por SMART de la integración con Codex.

smart mcp integrate codex off

Conecta Claude Code al servicio MCP local de SMART sin alterar la configuración no relacionada.

smart mcp integrate claude on

Elimina únicamente las entradas administradas por SMART de la integración con Claude Code.

smart mcp integrate claude off

Conecta Cursor al servicio MCP local de SMART sin alterar la configuración no relacionada.

smart mcp integrate cursor on

Elimina únicamente las entradas administradas por SMART de la integración con Cursor.

smart mcp integrate cursor off

Conecta Cline al servicio MCP local de SMART sin alterar la configuración no relacionada.

smart mcp integrate cline on

Elimina únicamente las entradas administradas por SMART de la integración con Cline.

smart mcp integrate cline off

Conecta Gemini CLI al servicio MCP local de SMART sin alterar la configuración no relacionada.

smart mcp integrate gemini-cli on

Elimina únicamente las entradas administradas por SMART de la integración con Gemini CLI.

smart mcp integrate gemini-cli off

Conecta GitHub Copilot CLI al servicio MCP local de SMART sin alterar la configuración no relacionada.

smart mcp integrate github-copilot-cli on

Elimina únicamente las entradas administradas por SMART de la integración con GitHub Copilot CLI.

smart mcp integrate github-copilot-cli off

Conecta Windsurf al servicio MCP local de SMART sin alterar la configuración no relacionada.

smart mcp integrate windsurf on

Elimina únicamente las entradas administradas por SMART de la integración con Windsurf.

smart mcp integrate windsurf off

Conecta Zed al servicio MCP local de SMART sin alterar la configuración no relacionada.

smart mcp integrate zed on

Elimina únicamente las entradas administradas por SMART de la integración con Zed.

smart mcp integrate zed off

Conecta VS Code al servicio MCP local de SMART sin alterar la configuración no relacionada.

smart mcp integrate vscode on

Elimina únicamente las entradas administradas por SMART de la integración con VS Code.

smart mcp integrate vscode off

Conecta JetBrains al servicio MCP local de SMART sin alterar la configuración no relacionada.

smart mcp integrate jetbrains on

Elimina únicamente las entradas administradas por SMART de la integración con JetBrains.

smart mcp integrate jetbrains off
Autocompletado del shell

Genera definiciones de autocompletado para el shell bash.

smart completion bash

Genera definiciones de autocompletado para el shell zsh.

smart completion zsh

Genera definiciones de autocompletado para el shell fish.

smart completion fish

Genera definiciones de autocompletado para el shell pwsh.

smart completion pwsh

Genera definiciones de autocompletado para el shell nu.

smart completion nu
Desinstalación

Detiene SMART y elimina sus integraciones de agentes y archivos de servicio administrados.

smart mcp uninstall
Salida legible por máquinas

Devuelve el estado de autenticación como JSON para scripts y herramientas de desarrollo.

smart auth status --json

Devuelve el estado del servicio MCP local de SMART como JSON para scripts y comprobaciones de estado.

smart mcp status --json
Ayuda y versión

Enumera los grupos de comandos de SMART y las opciones disponibles en cada uno.

smart help

Muestra la misma ayuda principal usando la forma de opción estándar.

smart --help

Muestra la versión instalada de la CLI de SMART.

smart version

Muestra la versión instalada de la CLI de SMART usando la forma de opción estándar.

smart --version