CLI 개요

suya CLI는 Subaya의 기본 인터페이스입니다 — 사람, AI 에이전트, CI 모두에게요. 플랫폼을 통해 할 수 있는 모든 것이 여기서 시작됩니다. subaya-dev.com의 웹 콘솔은 결과, 파형, 보고서, 검토를 위한 것입니다. 멘탈 모델은 핵심 개념을 참고하고, 설치에서 통과한 시뮬레이션까지 진행하려면 빠른 시작을 참고하십시오.

전역 플래그

이 플래그들은 모든 명령에서 작동합니다:

플래그	설명
--host <url>	대상 API 호스트. 기본값은 https://subaya-dev.com.
--token <token>	이번 호출에 명시적인 인증 토큰을 사용합니다.
--json	기계가 읽을 수 있는 JSON 출력을 내보냅니다.
--pretty	사람을 위해 출력을 보기 좋게 표시합니다.
-q, --quiet	비필수 출력을 억제합니다.
-v, --verbose	추가 진단 세부 정보를 출력합니다.

--json은 에이전트 및 CI와 잘 어울리며, --pretty는 터미널을 위한 친화적인 기본값입니다.

프로젝트 설정 — .subaya/config.toml

대부분의 프로젝트 범위 명령은 기본 --project를 로컬 .subaya/config.toml 파일에서 읽습니다. 일단 디렉터리에서 프로젝트가 초기화되면( suya project 참고), suya project show, suya sim run, suya repo status 같은 명령이 매번 --project를 전달하지 않아도 해당 프로젝트에 대해 작동합니다. 재정의하려면 --project <project-id>를 명시적으로 전달하십시오.

인증

두 가지 모드가 동일한 API에 대해 결정됩니다 — 자세한 내용은 인증 및 API 키와 suya auth 레퍼런스에 있습니다:

• SUBAYA_API_KEY — 에이전트 및 CI용 환경 변수. 브라우저 불필요.
• suya auth login — 사람 개발자를 위한 OAuth 브라우저 흐름.

export SUBAYA_API_KEY="sk_..."
suya auth whoami

명령 그룹

그룹	하는 일
suya auth	로그인, 로그아웃, 신원 확인.
suya project	프로젝트와 단계를 생성, 나열, 관리.
suya sim	클라우드 시뮬레이션을 실행하고 결과를 살펴봅니다.
suya hw	하드웨어 검증 실행 및 에이전트 관리 (BitCrucible).
suya rag	지식 베이스를 검색하고 읽습니다.
suya plan	계획 문서, 작업 항목, 다이어그램.
suya repo	프로젝트를 위한 GitHub 저장소를 생성하거나 연결합니다.
suya device	디바이스 카탈로그를 탐색하고 디바이스를 할당합니다.
Session	세션 파드를 suya attach / suya detach.

추가 명령 그룹

이 그룹들이 표면을 마무리합니다:

• suya arch — 아키텍처 및 임베디드 핀 계획 (모듈, 핀 계획, 주변장치/클록 설정, validate, generate, .ioc 커밋).
• suya req — 프로젝트의 요구사항을 추가하고 나열 (suya req add, suya req list).
• suya review — 코드 및 설계 검토 (create, show, list, comment, reply, resolve, approve, 그 외).
• suya diagram — Mermaid 다이어그램을 작성하고 SVG/PNG로 렌더링 (create, update, show, list, export, render, delete).

최상위 명령

명령	설명
suya version	버전 메타데이터를 출력합니다.
suya update [--check]	최신 릴리스로 업그레이드합니다. --check는 가용성만 보고합니다.
suya install [--skills] [--path <p>] [--force]	Subaya 통합을 설치합니다 (suya-cli + planner 스킬 번들).
suya completion <shell>	주어진 셸에 대한 셸 자동 완성을 출력합니다.