Comandi disponibili nella CLI

Comprendi come il binario alti distribuito instrada una riga di comando, quali namespace sono raggiungibili in questo rilascio, cosa significa ogni codice di uscita e dove viene eseguito ogni comando.

Panoramica

Questa pagina indicizza CLI nativa, manifest delle azioni cliente e connessioni specifiche dei backend. Usa Comandi Engine per lavorare sul progetto locale e Comandi job e Cloud per le operazioni dei servizi. Gli esempi si applicano all'interfaccia 0.1.9.

Due parser, un solo binario

Il parser nativo gestisce release, capabilities, rtl, sv, verification, trace, labs, tcl, eidb, eda, reports, physical, px, isa, ide, job, xls, e compute. Gestisce anche analyze run e le forme Evolve esplicite capabilities, analyze, run, cx-search, measured-ppa, e artifact. Gli altri comandi cliente usano il manifest delle azioni incorporato. mcp serve avvia il server MCP stdio.

Cosa esclude questo instradamento

eda inspect, reports parse, ide init, e le forme Evolve elencate sono comandi instradati nativamente. La loro disponibilità non è più limitata dalle omissioni di dispatch del vecchio archivio. Le capacità dell'Engine determinano comunque quali input o operazioni sono supportati.

L'azione cliente di una sola parola evolve è separata da quella nativa evolve run e compute rtl-evolve. I loro schemi di richiesta non sono intercambiabili. L'azione di una sola parola trace del manifest resta mascherata dal namespace nativo trace; usa i sottocomandi nativi invece di presumere che l'enumerazione del manifest garantisca una grafia CLI corrispondente.

Flag globali

Usa --json all'inizio per output strutturato nativo, per esempio alti --json xls capabilities. Posizionalo prima del namespace o dopo il sottocomando nativo completo, non tra le parole di una forma Evolve instradata. Usa alti --help per il riepilogo generale e --help sull'operazione foglia per argomenti accettati e limiti. I comandi foglia nativi accettano anche -h.

L'output JSON è specifico del comando. Gli envelope dell'Engine contengono il risultato del figlio come stringa, i comandi dei servizi restituiscono ricevute e i collegamenti ai terminali trasmettono byte. Consulta Riferimento dei comandi.

Comandi meta e account

Comando

Comportamento

alti version, alti --version

Mostra la versione della CLI

alti commands

Mostra il manifest delle 25 azioni cliente

alti capabilities

Ispeziona l'installazione autenticata e le sue capacità

alti auth status

Riporta la configurazione dell'ambiente senza verificare l'identità del server

alti login, alti whoami

I comandi legacy di primo livello rifiutano l'identità non verificata con uscita 4

alti logout

Il comando legacy non può rimuovere credenziali ereditate dal processo padre

alti ide cloud login

Avvia il flusso PKCE nativo nel browser e archivia una sessione CLI privata

alti ide cloud whoami

Chiede al server l'identità della sessione corrente

alti ide cloud refresh, alti ide cloud logout

Aggiorna o revoca la sessione CLI nativa

alti mcp serve

Fornisce MCP stdio nella modalità cliente o XLS locale selezionata

Sessioni Cloud e credenziali legacy dell'ambiente sono distinte. Consulta Autenticazione CLI.

Codici di uscita

Tratta ogni risultato non nullo come errore, a meno che il contratto del comando specifico definisca un'azione di recupero. Parsing/ammissione restituiscono comunemente 2, errori runtime e HTTP 1, engine indisponibili 127, ed esecuzione installata non valida o errori di avvio 126. Gli engine possono propagare i propri stati. Il manifest cliente usa separatamente 3 per un rifiuto di classe e 4 per un rifiuto prima del dispatch. Un numero di stato da solo non ne identifica l'origine.

Dove viene eseguito cosa

Superficie

Esecuzione e autorità

xls, compute, comandi engine locali tipizzati

Engine nativi inclusi nel pacchetto sulla macchina corrente

xls upstream

Strumenti Google XLS installati separatamente e vincolati sulla macchina Linux corrente

ide workspace

La directory locale selezionata, compresi recupero e mutazioni native serializzate

ide cloud

Route API native con sessione bearer emessa dal browser e permessi di organizzazione/progetto verificati dal server

ide service

Un servizio HTTP DDS legacy selezionato dall'operatore con il contratto esistente del segreto di servizio

job validate

Solo validazione offline di sorgenti ed envelope

job ... --runner cloud, analyze run

Il servizio job Cloud configurato, soggetto a disponibilità e permessi

MCP cliente predefinito

Dispatch del client Cloud; il trasporto stdio non rende locale l'esecuzione

ALTI_MCP_MODE=local-xls MCP

Strumenti XLS locali fissi, senza dispatch Cloud cliente

Quali sottocomandi usano –runner

I comandi di compatibilità rtl compile, rtl synthesize, physical run, px analyze, e isa run usano per impostazione predefinita local. Selezionare cloud o private su questi comandi emette un piano di dispatch preliminare; non è esecuzione remota. I loro argomenti engine -- sono accettati solo per il dispatch locale.

La famiglia job usa --runner per selezionare un Job Service, con un contratto diverso. L’adattatore ritirato alti-engine-job non è nell'inventario del rilascio dei 24 runner; non interpretare la sintassi accettata local/private come un servizio consegnato.

Come viene individuato un engine locale

Mantieni integro il rilascio installato. XLS, compute, RTL impacchettato, DDS nativo e percorsi PX/CX tipizzati richiedono l'eseguibile fratello indicato. La verifica di fiducia dell'installazione lega i runner protetti agli hash del catalogo e alle ricevute; nessun fallback PATH o ricevuta fornita dall'utente può ripristinare quel confine. I vecchi resolver di compatibilità possono riportare sibling o path; ispeziona la ricevuta dell'operazione effettivamente eseguita.

Quale engine serve ciascun namespace

Il payload contiene alti, alti-mcp, e questi 24 runner engine:

Comandi

Engine inclusi nel pacchetto

RTL, analisi, SV, verifica

alti-rtlc, alti-rtl, alti-rtl-analyze, alti-sv-frontend, alti-sv-immediate-review, alti-sv-interprocess-review, alti-golden-diff

ISA, Evolve

alti-cx, alti-evolve

Fisico, PX

alti-physical-runner, alti-px-runner, alti-px-sta-graph-check

Trace, Labs

alti-trace, alti-lab

Tcl, EIDB, EDA, report

alti-tcl, alti-tcl-local-runner, alti-eidb-local-runner, alti-eda-artifact-inspect, alti-reports

XLS e compute

alti-xls, alti-compute, alti-packed-cuda, alti-rtl-cuda

DDS nativo

alti-ide-workspace

alti-rtl-runner non è incluso nel pacchetto. I comandi di compatibilità con identità confermata che lo richiedono non diventano supportati solo perché hanno un help. L'eseguibile desktop usato da ide open è distribuito separatamente.

Envelope delle ricevute

Schema o output

Interpretazione

altifigence.local-engine-execution.v1

Con --json, comando, eseguibile, risoluzione, stato, exitCode, e flussi dell'engine acquisiti

altifigence.cli.engine-job-preflight.v1

Validazione offline; submitted e server_authority_verified restano false

altifigence.cli.tcl-evaluation.v1

Risultato della valutazione Tcl installata con limiti definiti

altifigence.ide-launcher-receipt.v1

Stato di avvio del processo desktop, non prova del completamento del caricamento di un progetto

altifigence.dds.service-receipt.v1

Stato HTTP del servizio legacy e corpo della risposta con limiti definiti

altifigence.cli.release-bootstrap.v1

Stato di completamento dell'installer/uninstaller con diagnostica dell'helper su stderr

stdout del terminale Cloud

Byte del terminale in streaming, non una singola ricevuta JSON

Il campo stdout di un envelope engine è una stringa contenente il risultato nativo. Senza --json, l'output nativo può essere salvato direttamente e passato integro a un comando DDS apply corrispondente. Non ridurre mai un piano di creazione al solo hash.

Variabili d'ambiente

Variabile

Ambito

ALTI_TOKEN, ALTI_ORG_ID

Credenziali del client legacy per azioni/job cliente e ambito dell'organizzazione

ALTI_API_BASE

Override dell'origine API legacy; valore predefinito https://api.altifigence.com

ALTI_BYO

Selezione legacy del tipo di principal; non è un permesso di esecuzione

ALTI_ALLOW_SOURCE_UPLOAD

Consenso al caricamento dei sorgenti per azioni MCP cliente

ALTI_MCP_MODE

customer per impostazione predefinita, oppure esplicito local-xls

ALTI_STUDIO_ENDPOINT

Origine esplicita del servizio DDS legacy; Cloud nativo usa argomenti propri per endpoint/sessione

ALTI_STUDIO_SERVICE_SECRET

Autenticazione esistente del servizio legacy; non è una sessione bearer Cloud nativa

ALTIF_RTL_IVERILOG, ALTIF_RTL_VVP

Posizioni degli strumenti Icarus esterni di proprietà dell'host per il valutatore RTL nativo

Cloud nativo usa --session-dir, con valore predefinito ~/.local/state/altifigence/cloud-cli. Non copiarvi file di sessione desktop, non registrare token nei log né inviare segreti di servizio a endpoint arbitrari.

Risultati dell'Engine

Leggi il risultato effettivo dell'Engine e i suoi limiti. Il rilevamento della GPU non è esecuzione su GPU, un digest del contenuto non è una firma e una stima temporale senza signoff non è un'approvazione finale dell'implementazione. La pagina successiva elenca i comandi engine.

Risolvere un comando prima di usarlo negli script

Bash
alti --version
alti --help
alti ide cloud --help
alti xls run --help

Verifica l'help sull'esatta operazione foglia che intendi invocare. Un nome corrispondente in alti commands non sostituisce l'help del parser nativo, le capacità installate o la disponibilità runtime. Conserva la versione CLI con gli script, poiché schemi delle richieste e ricevute sono versionati.