Conjunto de comandos da CLI
Entenda como o binário alti distribuído encaminha uma linha de comando, quais namespaces são acessíveis nesta versão, o significado de cada código de saída e onde cada comando realmente é executado.
Visão geral
Esta página indexa a CLI nativa, o manifesto de ações para clientes e as conexões específicas de cada backend. Use Comandos de mecanismos para trabalho local de projeto e Comandos de jobs e Cloud para operações de serviços. Os exemplos se aplicam à interface 0.1.9.
Dois analisadores, um binário
O analisador nativo trata release, capabilities, rtl, sv, verification, trace, labs, tcl, eidb, eda, reports, physical, px, isa, ide, job, xls e compute. Ele também trata analyze run e as formas explícitas de Evolve capabilities, analyze, run, cx-search, measured-ppa e artifact. Os comandos restantes para clientes usam o manifesto de ações incorporado. mcp serve inicia o servidor MCP stdio.
O que esse encaminhamento exclui
eda inspect, reports parse, ide init e as formas listadas de Evolve são comandos nativos encaminhados. Sua disponibilidade não é mais limitada pelas omissões de encaminhamento do arquivo compactado anterior. Os recursos dos mecanismos ainda determinam qual entrada ou operação é compatível.
A ação de uma palavra evolve para clientes é separada de evolve run e compute rtl-evolve nativos. Seus esquemas de requisição não são intercambiáveis. A ação de uma palavra trace do manifesto continua encoberta pelo namespace nativo trace; use os subcomandos nativos em vez de presumir que a enumeração no manifesto garanta uma grafia correspondente na CLI.
Opções globais
Use um --json inicial para saída estruturada nativa, por exemplo alti --json xls capabilities. Coloque-o antes do namespace ou após o subcomando nativo completo, não entre as palavras de uma forma encaminhada de Evolve. Use alti --help para o resumo de nível superior e --help na operação específica para os argumentos e limites aceitos. Comandos nativos específicos também aceitam -h.
A saída JSON é específica de cada comando. Os envelopes de mecanismos contêm o resultado do processo filho como uma string, comandos de serviços retornam comprovantes e conexões de terminal transmitem bytes. Consulte Referência de comandos.
Comandos de metadados e conta
Comando | Comportamento |
|---|---|
| Exibir a versão da CLI |
| Exibir o manifesto de ações para clientes com 25 entradas |
| Inspecionar a instalação autenticada e seus recursos |
| Informar a configuração do ambiente sem verificar a identidade no servidor |
| Comandos legados de nível superior recusam identidades não verificadas com código de saída |
| O comando legado não pode remover credenciais herdadas de seu processo pai |
| Iniciar o fluxo nativo PKCE no navegador e armazenar uma sessão privada da CLI |
| Consultar o servidor sobre a identidade da sessão atual |
| Atualizar ou revogar a sessão nativa da CLI |
| Servir MCP stdio no modo selecionado para clientes ou XLS local |
Sessões do Cloud e credenciais legadas de ambiente são distintas. Consulte Autenticação da CLI.
Códigos de saída
Trate todo resultado diferente de zero como falha, a menos que o contrato do comando específico defina uma ação de recuperação. Análise/admissão normalmente retorna 2, falhas de execução e HTTP 1, mecanismos indisponíveis 127 e execução instalada inválida ou falhas de inicialização 126. Os mecanismos podem repassar seus próprios códigos. O manifesto para clientes usa separadamente 3 para rejeição de classe e 4 para recusa antes do encaminhamento. Um número de código, por si só, não identifica sua origem.
O que é executado onde
Interface | Execução e autoridade |
|---|---|
| Mecanismos nativos empacotados na máquina atual |
| Ferramentas Google XLS fixadas e instaladas separadamente na máquina Linux atual |
| O diretório local selecionado, incluindo recuperação e alterações nativas serializadas |
| Rotas de API nativas com sessão bearer emitida pelo navegador e permissões de organização/projeto verificadas no servidor |
| Um serviço HTTP legado do DDS selecionado pelo operador, com seu contrato existente de segredo de serviço |
| Apenas validação offline dos arquivos-fonte e do envelope |
| O serviço configurado de jobs do Cloud, sujeito a prontidão e permissões |
MCP padrão para clientes | Encaminhamento pelo cliente do Cloud; o transporte stdio não torna a execução local |
| Ferramentas locais fixas de XLS, sem encaminhamento ao Cloud para clientes |
Quais subcomandos têm –runner
Os comandos de compatibilidade rtl compile, rtl synthesize, physical run, px analyze e isa run usam por padrão local. Selecionar cloud ou private nesses comandos emite um plano inicial de encaminhamento; não é execução remota. Seus argumentos de mecanismo -- são aceitos apenas para encaminhamento local.
Na família job, --runner seleciona um Job Service e é um contrato diferente. O adaptador retirado alti-engine-job não está no inventário de 24 runners da versão; não interprete a sintaxe aceita de local/private como um serviço entregue.
Como um mecanismo local é encontrado
Mantenha intacta a versão instalada. XLS, compute, RTL compactado, DDS nativo e os caminhos tipados PX/CX exigem seu executável associado nomeado. A verificação de confiança da instalação vincula runners protegidos a hashes do catálogo e comprovantes; nenhuma alternativa por PATH ou comprovante fornecido pelo usuário corrige esse limite. Os resolvedores antigos de compatibilidade podem informar sibling ou path; inspecione o comprovante da operação que você realmente executou. Ferramentas externas como Icarus têm configuração separada no host.
Qual mecanismo atende a cada namespace
O conteúdo inclui alti, alti-mcp e estes 24 runners de mecanismos:
Comandos | Mecanismos empacotados |
|---|---|
RTL, análise, SV, verificação |
|
ISA, Evolve |
|
Físico, PX |
|
Rastros, Labs |
|
Tcl, EIDB, EDA, relatórios |
|
XLS e compute |
|
DDS nativo |
|
alti-rtl-runner não está empacotado. Os comandos de compatibilidade de identidade confirmada que o solicitam não passam a ser compatíveis apenas porque sua ajuda existe. O executável desktop usado por ide open é distribuído separadamente.
Envelopes de comprovantes
Esquema ou saída | Interpretação |
|---|---|
| Com |
| Validação offline; |
| Resultado de avaliação Tcl instalada com limites definidos |
| Estado de inicialização do processo desktop, não prova de que um projeto terminou de carregar |
| Código HTTP do serviço legado e corpo de resposta limitado |
| Estado de conclusão do instalador/desinstalador com diagnósticos auxiliares em stderr |
Stdout do terminal do Cloud | Bytes de terminal transmitidos, não um único comprovante JSON |
O stdout de um envelope de mecanismo é uma string que contém o resultado nativo. Sem --json, essa saída nativa pode ser salva diretamente e passada intacta a um comando apply correspondente do DDS. Nunca reduza um plano de criação apenas ao seu hash.
Variáveis de ambiente
Variável | Escopo |
|---|---|
| Credenciais legadas de clientes de ações/jobs e escopo da organização |
| Substituição da origem da API legada; padrão |
| Seleção legada do tipo de principal; não é permissão para executar |
| Consentimento para envio de arquivos-fonte em ações MCP para clientes |
|
|
| Origem explícita do serviço legado do DDS; Cloud nativo usa seus próprios argumentos de endpoint/sessão |
| Autenticação existente do serviço legado; não é uma sessão bearer nativa do Cloud |
| Locais das ferramentas externas Icarus controlados pelo host para o avaliador nativo de RTL |
Cloud nativo usa --session-dir, com padrão ~/.local/state/altifigence/cloud-cli. Não copie arquivos de sessão desktop para esse local, registre tokens em logs nem envie segredos de serviço para endpoints arbitrários.
Resultados de mecanismos
Leia o resultado real do mecanismo e seus limites. Descoberta de GPU não é execução em GPU, um hash de conteúdo não é uma assinatura e uma estimativa de temporização sem signoff não é signoff de implementação. A próxima página lista os comandos de mecanismos relevantes.
Resolva um comando antes de criar scripts
alti --version
alti --help
alti ide cloud --help
alti xls run --help
Confira a ajuda da operação específica que pretende chamar. Um nome correspondente em alti commands não substitui a ajuda do analisador nativo, os recursos instalados nem a disponibilidade do ambiente de execução. Mantenha a versão da CLI junto com os scripts porque esquemas de requisição e comprovantes são versionados.