Superficie de comandos de la CLI
Entiende cómo el binario alti distribuido enruta una línea de comandos, qué espacios de nombres están disponibles en esta versión, qué significa cada código de salida y dónde se ejecuta realmente cada comando.
Descripción general
Esta página indexa la CLI nativa, el manifiesto de acciones del cliente y las conexiones específicas de cada backend. Usa Comandos de Engine para trabajo de diseño local y Comandos de trabajos y Cloud para operaciones de servicio. Los ejemplos se aplican a la interfaz 0.1.9.
Dos analizadores, un binario
El analizador nativo gestiona release, capabilities, rtl, sv, verification, trace, labs, tcl, eidb, eda, reports, physical, px, isa, ide, job, xls, y compute. También gestiona analyze run y las formas explícitas de Evolve capabilities, analyze, run, cx-search, measured-ppa, y artifact. Los demás comandos del cliente utilizan el manifiesto de acciones integrado. mcp serve inicia el servidor MCP por stdio.
Qué excluye este enrutamiento
eda inspect, reports parse, ide init y las formas de Evolve enumeradas son comandos enrutados de forma nativa. Su disponibilidad ya no está limitada por las omisiones de despacho del archivo anterior. Las capacidades de Engine siguen determinando qué entradas u operaciones se admiten.
La acción de cliente de una palabra evolve es distinta de las formas nativas evolve run y compute rtl-evolve. Sus esquemas de solicitudes no son intercambiables. La acción de una palabra del manifiesto trace sigue oculta por el espacio de nombres nativo trace; utiliza los subcomandos nativos en lugar de suponer que la enumeración del manifiesto garantiza una escritura coincidente en la CLI.
Opciones globales
Usa --json al principio para obtener salida estructurada nativa, por ejemplo alti --json xls capabilities. Colócalo antes del espacio de nombres o después del subcomando nativo completo, no entre las palabras de una forma enrutada de Evolve. Usa alti --help para el resumen de nivel superior y --help en la operación final para los argumentos y límites admitidos. Los comandos nativos finales también aceptan -h.
La salida JSON depende del comando. Los sobres de Engine contienen el resultado del hijo como cadena, los comandos de servicio devuelven comprobantes y las conexiones de terminal transmiten bytes. Consulta Referencia de comandos.
Comandos de metadatos y cuenta
Comando | Comportamiento |
|---|---|
| Muestra la versión de la CLI |
| Muestra el manifiesto de 25 acciones del cliente |
| Inspecciona la instalación autenticada y sus capacidades |
| Informa de la configuración del entorno sin verificar la identidad del servidor |
| Los comandos heredados de nivel superior rechazan identidades no verificadas con el código de salida |
| El comando heredado no puede eliminar credenciales heredadas de su proceso padre |
| Inicia el flujo PKCE nativo del navegador y almacena una sesión privada de CLI |
| Consulta al servidor la identidad actual de la sesión |
| Actualiza o revoca la sesión nativa de CLI |
| Sirve MCP por stdio en el modo seleccionado de cliente o XLS local |
Las sesiones Cloud y las credenciales heredadas del entorno son distintas. Consulta Autenticación de la CLI.
Códigos de salida
Trata todo resultado distinto de cero como fallo, salvo que el contrato del comando concreto defina una acción de recuperación. El análisis/admisión suele devolver 2, los fallos de runtime y HTTP 1, los motores no disponibles 127 y la ejecución instalada no válida o los fallos de lanzamiento 126. Los motores pueden transmitir sus propios estados. El manifiesto del cliente usa por separado 3 para un rechazo de clase y 4 para un rechazo previo al despacho. Un número de estado por sí solo no identifica su origen.
Qué se ejecuta dónde
Superficie | Ejecución y autoridad |
|---|---|
| Motores nativos empaquetados en la máquina actual |
| Herramientas Google XLS instaladas por separado y fijadas en la máquina Linux actual |
| El directorio local seleccionado, incluidas recuperación y mutaciones nativas serializadas |
| Rutas de API nativa con sesión bearer emitida por el navegador y permisos de organización/proyecto comprobados por el servidor |
| Un servicio HTTP DDS heredado seleccionado por el operador, con su contrato existente de secreto de servicio |
| Solo validación sin conexión de fuentes y sobres |
| El servicio de trabajos Cloud configurado, sujeto a disponibilidad y permisos |
MCP predeterminado del cliente | Despacho del cliente Cloud; el transporte stdio no hace local la ejecución |
| Herramientas XLS locales fijas, sin despacho Cloud del cliente |
Qué subcomandos llevan –runner
Los comandos de compatibilidad rtl compile, rtl synthesize, physical run, px analyze, y isa run usan de forma predeterminada local. Seleccionar cloud o private en esos comandos emite un plan de despacho preliminar; no es ejecución remota. Sus argumentos de motor -- se aceptan solo para despacho local.
La familia job utiliza --runner para seleccionar un Job Service y es un contrato distinto. El adaptador retirado alti-engine-job no está en el inventario de 24 runners de la versión; no interpretes la sintaxis aceptada local/private como un servicio entregado.
Cómo se encuentra un motor local
Mantén intacta la versión instalada. XLS, compute, RTL empaquetado, DDS nativo y las rutas tipadas PX/CX requieren su ejecutable hermano especificado. La comprobación de confianza de la instalación vincula runners protegidos a hashes y comprobantes del catálogo; ningún recurso alternativo PATH ni comprobante proporcionado por el usuario repara ese límite. Los resolutores antiguos de compatibilidad pueden informar de sibling o path; inspecciona el comprobante de la operación que realmente ejecutaste. Las herramientas externas como Icarus tienen una configuración del host separada.
Qué motor respalda cada espacio de nombres
La carga útil contiene alti, alti-mcp y estos 24 runners de Engine:
Comandos | Motores empaquetados |
|---|---|
RTL, análisis, SV y verificación |
|
ISA, Evolve |
|
Físico, PX |
|
Trace, Labs |
|
Tcl, EIDB, EDA e informes |
|
XLS y compute |
|
DDS nativo |
|
alti-rtl-runner no está empaquetado. Los comandos de compatibilidad de identidad confirmada que lo solicitan no obtienen soporte simplemente porque exista su ayuda. El ejecutable de escritorio utilizado por ide open se distribuye por separado.
Sobres de comprobantes
Esquema o salida | Interpretación |
|---|---|
| Con |
| Validación sin conexión; |
| Resultado acotado de evaluación Tcl de la instalación |
| Estado de lanzamiento del proceso de escritorio, no prueba de que terminó de cargarse un proyecto |
| Estado HTTP del servicio heredado y cuerpo de respuesta acotado |
| Estado de finalización del instalador/desinstalador con diagnóstico del asistente en stderr |
stdout de la terminal Cloud | Bytes transmitidos de terminal, no un comprobante JSON único |
El campo stdout de un sobre de Engine es una cadena que contiene el resultado nativo. Sin --json, esa salida nativa puede guardarse directamente y pasarse intacta a un comando DDS de aplicación correspondiente. Nunca reduzcas un plan de creación a solo su hash.
Variables de entorno
Variable | Ámbito |
|---|---|
| Credenciales del cliente heredado de acciones/trabajos y ámbito de organización |
| Sustitución del origen de API heredada; valor predeterminado |
| Selección del tipo de principal heredado; no concede permiso de ejecución |
| Consentimiento de subida de fuentes para acciones MCP del cliente |
|
|
| Origen explícito del servicio DDS heredado; Cloud nativo usa sus propios argumentos de endpoint/sesión |
| Autenticación existente del servicio heredado; no es una sesión bearer de Cloud nativo |
| Ubicaciones de herramientas Icarus externas controladas por el host para el evaluador RTL nativo |
Cloud nativo usa --session-dir con el valor predeterminado ~/.local/state/altifigence/cloud-cli. No copies en él archivos de sesión del escritorio, registres tokens ni envíes secretos de servicio a endpoints arbitrarios.
Resultados de Engine
Lee el resultado real del motor y sus límites. Descubrir una GPU no es ejecutar en GPU, un resumen de contenido no es una firma y una estimación de temporización sin signoff no es aprobación de implementación. La siguiente página enumera los comandos de Engine.
Resuelve un comando antes de crear scripts
alti --version
alti --help
alti ide cloud --help
alti xls run --help
Comprueba la ayuda de la operación final exacta que pretendes invocar. Un nombre coincidente en alti commands no sustituye la ayuda del analizador nativo, las capacidades instaladas ni la disponibilidad del runtime. Conserva la versión de la CLI con los scripts porque los esquemas de solicitudes y los comprobantes están versionados.