CLI 명령어 범위 — Altifigence Documentation

배포된 alti 실행 파일의 명령 처리 방식, 이번 릴리스에서 접근 가능한 이름 공간, 각 종료 코드의 의미, 명령의 실제 실행 위치를 확인하세요.

개요

이 페이지는 네이티브 CLI, 고객 액션 manifest, 백엔드별 연결을 안내합니다. 로컬 설계 작업은 엔진 명령, 서비스 작업은 Job 및 Cloud 명령을 참조하세요. 예제는 0.1.9 인터페이스에 적용됩니다.

두 파서, 하나의 바이너리

네이티브 파서는 release, capabilities, rtl, sv, verification, trace, labs, tcl, eidb, eda, reports, physical, px, isa, ide, job, xls, compute를 처리합니다. analyze run과 명시적 Evolve 형식인 capabilities, analyze, run, cx-search, measured-ppa, artifact도 처리합니다. 나머지 고객 명령은 내장 액션 manifest를 사용합니다. mcp serve는 stdio MCP 서버를 시작합니다.

이 라우팅에서 제외되는 항목

eda inspect, reports parse, ide init, 위 Evolve 형식은 네이티브 경로로 연결된 명령입니다. 이전 압축 패키지의 명령 연결 누락으로 제한되지 않습니다. 지원되는 입력과 작업은 여전히 엔진 기능이 결정합니다.

한 단어인 고객 evolve 액션은 네이티브 evolve run, compute rtl-evolve와 별개입니다. 요청 스키마는 서로 교환할 수 없습니다. manifest의 한 단어 trace 액션은 네이티브 trace 이름 공간에 가려집니다. manifest에 있다고 같은 CLI 표기가 동작한다고 가정하지 말고 네이티브 하위 명령을 사용하세요.

글로벌 플래그

네이티브 구조화 출력에는 alti --json xls capabilities처럼 앞쪽의 --json을 사용하세요. 이름 공간 앞이나 완전한 네이티브 하위 명령 뒤에 두고, 연결된 Evolve 형식의 단어 사이에는 넣지 마세요. 최상위 요약은 alti --help, 허용 인수와 제한은 개별 작업의 --help로 확인합니다. 네이티브 개별 명령은 -h도 받습니다.

JSON 출력은 명령마다 다릅니다. 엔진 응답은 자식 결과를 문자열로 포함하고, 서비스 명령은 영수증을 반환하며, 터미널 연결은 바이트를 스트리밍합니다. 명령 레퍼런스를 참조하세요.

메타 및 계정 명령

명령	동작
`alti` `version`, `alti` `--version`	CLI 버전 출력
`alti` `commands`	항목 25개의 고객 액션 manifest 출력
`alti` `capabilities`	진위가 검증된 설치와 기능 확인
`alti` `auth` `status`	서버 식별 정보를 검증하지 않고 환경 설정 보고
`alti` `login`, `alti` `whoami`	레거시 최상위 명령은 종료 코드 `4`로 검증되지 않은 식별 정보를 거부
`alti` `logout`	레거시 명령은 부모 프로세스에서 상속한 자격 증명을 제거할 수 없음
`alti` `ide` `cloud` `login`	네이티브 브라우저 PKCE 흐름을 시작하고 비공개 CLI 세션 저장
`alti` `ide` `cloud` `whoami`	서버에 현재 세션의 식별 정보 요청
`alti` `ide` `cloud` `refresh`, `alti` `ide` `cloud` `logout`	네이티브 CLI 세션 갱신 또는 취소
`alti` `mcp` `serve`	선택한 고객 모드 또는 로컬 XLS 모드에서 stdio MCP 제공

Cloud 세션과 레거시 환경 자격 증명은 별개입니다. CLI 인증을 참조하세요.

종료 코드

해당 명령의 계약에서 복구 동작을 정의한 경우를 제외하고 0이 아닌 결과는 실패로 처리하세요. 일반적으로 파싱·요청 허용 검사는 2, 런타임·HTTP 실패는 1, 사용 불가능한 엔진은 127, 잘못된 설치 실행·시작 실패는 126을 반환합니다. 엔진 자체 상태가 전달될 수도 있습니다. 고객 manifest는 별도로 클래스 거부에 3, 전달 전 거부에 4를 사용합니다. 상태 숫자만으로는 발생 위치를 알 수 없습니다.

실행 위치

화면	실행 및 권한
`xls`, `compute`, 타입 기반 로컬 엔진 명령	현재 컴퓨터의 패키지 네이티브 엔진
`xls` `upstream`	현재 Linux 컴퓨터에 별도로 설치한 버전 고정 Google XLS 도구
`ide` `workspace`	복구와 순서대로 처리되는 네이티브 변경을 포함한 선택된 로컬 디렉터리
`ide` `cloud`	브라우저에서 발급한 bearer 세션과 서버가 확인한 조직·프로젝트 권한을 사용하는 네이티브 API 경로
`ide` `service`	운영자가 선택한 레거시 DDS HTTP 서비스와 기존 서비스 비밀 계약
`job` `validate`	오프라인 소스·요청 검증만 수행
`job` `...` `--runner` `cloud`, `analyze` `run`	준비 상태와 권한을 따르는 설정된 Cloud 작업 서비스
기본 고객 MCP	Cloud 클라이언트 전달. stdio 통신이 실행을 로컬로 바꾸지는 않습니다.
`ALTI_MCP_MODE=local-xls` MCP	고객 Cloud 전달 없이 사용하는 고정 로컬 XLS 도구

–runner를 사용하는 하위 명령

호환 명령 rtl compile, rtl synthesize, physical run, px analyze, isa run의 기본값은 local입니다. 이 명령에서 cloud나 private를 선택하면 전달 계획의 기본 구조를 출력하며 원격 실행은 하지 않습니다. -- 뒤의 엔진 인수는 로컬 전달에서만 받습니다.

job 명령군의 --runner는 Job Service를 선택하는 별도 계약입니다. 폐기된 alti-engine-job 어댑터는 실행기 24개의 릴리스 목록에 없습니다. local·private 구문을 받는다는 사실을 서비스 제공으로 해석하지 마세요.

로컬 엔진 탐색 방식

설치된 릴리스를 그대로 유지하세요. XLS, compute, packed RTL, 네이티브 DDS, 타입 기반 PX/CX 경로에는 지정된 형제 실행 파일이 필요합니다. 설치 신뢰 검사는 보호된 실행기를 카탈로그 해시와 영수증에 연결합니다. PATH 대체 경로나 사용자 작성 영수증으로 이 경계를 복구할 수 없습니다. 이전 호환 탐색기는 sibling 또는 path를 보고할 수 있으므로 실제 실행한 작업의 영수증을 확인하세요. Icarus 같은 외부 도구는 별도의 호스트 설정을 사용합니다.

네임스페이스별 실행 엔진

파일 묶음에는 alti, alti-mcp와 다음 엔진 실행기 24개가 포함됩니다.

명령	패키지 엔진
RTL, 분석, SV, 검증	`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`
Physical, PX	`alti-physical-runner`, `alti-px-runner`, `alti-px-sta-graph-check`
Trace, Labs	`alti-trace`, `alti-lab`
Tcl, EIDB, EDA, 보고서	`alti-tcl`, `alti-tcl-local-runner`, `alti-eidb-local-runner`, `alti-eda-artifact-inspect`, `alti-reports`
XLS 및 compute	`alti-xls`, `alti-compute`, `alti-packed-cuda`, `alti-rtl-cuda`
네이티브 DDS	`alti-ide-workspace`

alti-rtl-runner는 패키지에 없습니다. 이를 요청하는 커밋 식별 정보 기반 호환 명령은 도움말이 있다는 이유만으로 지원되지 않습니다. ide open이 사용하는 데스크톱 실행 파일은 별도로 배포됩니다.

리시트 엔벌로프

스키마 또는 출력	통역
`altifigence.local-engine-execution.v1`	`--json` 사용 시 명령, 실행 파일, 탐색 결과, 상태, `exitCode`, 수집된 엔진 출력
`altifigence.cli.engine-job-preflight.v1`	오프라인 검증. `submitted`와 `server_authority_verified`는 false로 유지됩니다.
`altifigence.cli.tcl-evaluation.v1`	설치된 Tcl의 제한된 평가 결과
`altifigence.ide-launcher-receipt.v1`	데스크톱 프로세스 시작 상태. 프로젝트 로딩 완료의 증거는 아닙니다.
`altifigence.dds.service-receipt.v1`	레거시 서비스 HTTP 상태와 크기가 제한된 응답 본문
`altifigence.cli.release-bootstrap.v1`	설치·제거 완료 상태. 도우미 진단은 stderr로 보냅니다.
Cloud 터미널 stdout	스트리밍 터미널 바이트. 단일 JSON 영수증이 아닙니다.

엔진 응답의 stdout은 네이티브 결과가 들어 있는 문자열입니다. --json이 없으면 네이티브 출력을 직접 저장해 대응하는 DDS 적용 명령에 그대로 전달할 수 있습니다. 작성 계획을 해시 하나로 축약하지 마세요.

환경 변수

변수	범위
`ALTI_TOKEN`, `ALTI_ORG_ID`	레거시 고객 액션·작업 클라이언트 자격 증명과 조직 범위
`ALTI_API_BASE`	레거시 API origin 재정의. 기본값은 `https://api.altifigence.com`입니다.
`ALTI_BYO`	레거시 principal 유형 선택. 실행 권한은 아닙니다.
`ALTI_ALLOW_SOURCE_UPLOAD`	고객 MCP 액션의 소스 업로드 동의
`ALTI_MCP_MODE`	기본값 `customer` 또는 명시적 `local-xls`
`ALTI_STUDIO_ENDPOINT`	명시적인 레거시 DDS 서비스 origin. 네이티브 Cloud는 자체 엔드포인트·세션 인수를 사용합니다.
`ALTI_STUDIO_SERVICE_SECRET`	기존 레거시 서비스 인증. 네이티브 Cloud bearer 세션은 아닙니다.
`ALTIF_RTL_IVERILOG`, `ALTIF_RTL_VVP`	네이티브 RTL 평가기가 사용하는 호스트 소유 외부 Icarus 도구 위치

네이티브 Cloud는 --session-dir을 사용하며 기본값은 ~/.local/state/altifigence/cloud-cli입니다. 여기에 데스크톱 세션 파일을 복사하거나 토큰을 기록하거나 임의의 엔드포인트로 서비스 비밀을 보내지 마세요.

엔진 결과

실제 엔진 결과와 제한을 확인하세요. GPU 발견은 GPU 실행이 아니고, 내용 다이제스트는 서명이 아니며, non-signoff 타이밍 추정은 구현 signoff가 아닙니다. 다음 페이지에서 관련 엔진 명령을 안내합니다.

스크립트 작성 전 명령 확인

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

호출할 정확한 말단 명령의 도움말을 확인하세요. alti commands에 같은 이름이 있다고 native 파서 도움말·설치 기능·실행 가능 여부를 대신하지는 않습니다. 요청 스키마·결과 형식에 버전이 있으므로 스크립트와 CLI 버전을 함께 보관합니다.