Name: Cadenya CLI
SKU: -

소개

Cadenya CLI는 Cadenya API용 명령줄 인터페이스로, Cadenya에서 개발한 도구입니다. 이 CLI는 API 키 관리, 워크스페이스 설정, 목표 실행 및 스트리밍 이벤트 수신 등을 통해 에이전트 런타임과 상호작용할 수 있게 해줍니다. Windows, macOS, Linux에서 사용 가능하며, Chocolatey, Homebrew 또는 소스 빌드를 통해 설치할 수 있습니다.

상세정보

API 키 관리

cadenya api-keys 명령을 통해 API 키를 목록 조회, 검색, 생성할 수 있습니다. 응답은 들여쓴 JSON 형식으로 출력되며, 목록 명령은 nextCursor를 제공하여 페이지네이션을 지원합니다. –cursor 플래그를 사용하여 다음 페이지를 이어서 가져올 수 있습니다.

구성 및 기본값 설정

cadenya config 명령을 사용하여 workspace-id와 같은 기본값을 프로필별로 저장할 수 있습니다. config list로 현재 효과적인 값과 그 출처를 확인할 수 있으며, config unset으로 저장된 기본값을 제거할 수 있습니다. 워크스페이스 ID의 결정 순서는 –workspace-id 플래그, 환경 변수 CADENYA_WORKSPACE_ID, 저장된 기본값, 로그인된 워크스페이스 순입니다.

인증 및 로그인

cadenya auth login 명령을 실행하면 브라우저가 열려 기기 승인 흐름을 통해 인증할 수 있습니다. –no-browser 플래그를 사용하면 승인 URL만 출력할 수 있습니다. 인증 상태는 cadenya auth status로 확인하고, cadenya auth logout로 저장된 자격 증명을 삭제할 수 있습니다. 자격 증명은 ~/.cadenya/credentials에 mode 0600으로 저장되며, 출력되지 않습니다.

목표 실행 및 스트리밍

cadenya objectives stream-events 명령을 통해 특정 목표의 이벤트를 실시간으로 스트리밍할 수 있습니다. 연결이 끊어진 경우 –last-event-id 플래그를 사용하여 마지막 이벤트 ID부터 resumption이 가능합니다. 스트리밍된 이벤트는 NDJSON 형식으로, 각 줄이 독립적인 JSON 문서로 파싱됩니다. Ctrl-C 또는 SIGTERM으로 연결을 깨끗하게 종료할 수 있습니다.

디스플레이 모드

–display 플래그를 통해 출력 형식을 json, yaml, table, extended 중 하나로 변경할 수 있습니다. yaml 형식은 YAML 출력으로, table은 정렬된 텍스트로 현재 페이지의 데이터를 보여주며, extended는 psql 스타일의 세로 레코드를 제공합니다. 스트리밍 명령은 json 형식만 지원하며, 구성된 열이 없는 경우 table 또는 extended 사용 시 오류가 발생합니다.

다운로드·설치 방법

Windows에서는 Chocolatey를 사용하여 다음 PowerShell 명령으로 설치할 수 있습니다:

choco install cadenya

macOS 또는 Linux에서는 Homebrew를 통해 다음 명령으로 설치할 수 있습니다:

brew install cadenya/tools/cadenya

모든 플랫폼에 대한 사전 빌드된 아카이브는 GitHub 릴리스 페이지에서 체크섬과 함께 다운로드 가능하며, 소스에서 직접 빌드하려면 다음 Go 명령을 사용할 수 있습니다:

go install go.cadenya.com/cadenya-cli@latest

기본 사용법

설치 후, cadenya –version 명령을 실행하면 바이너리 릴리스 버전과 함께 API 계약 버전을 확인할 수 있습니다. API 키를 생성하려면 다음 명령을 사용합니다:

cadenya api-keys create –name

생성된 키는 -f 플래그를 통해 YAML 또는 JSON 파일 입력을 받을 수 있으며, 파일 입력과 플래그 입력을 결합하여 부분적으로 재정의할 수 있습니다. 예를 들어:

cadenya api-keys create -f body.yml –name staging

위 명령은 body.yml 파일을 읽고, –name 플래그로 name 값을 재정의합니다.

지원 환경·시스템 요구사항

증거에서 특정 운영 체제 버전이나 하드웨어 요구사항에 대한 언급이 없으므로, 이 섹션은 생략합니다.

제한 사항·확인 사항

증거에서 특정 제한 사항이나 확인 사항에 대한 언급이 없으므로, 이 섹션은 생략합니다.

FAQ

질문: Cadenya CLI는 무료로 사용할 수 있나요?
답변: 증거에서 라이선스 정보는 Apache-2.0로 명시되어 있으며, 이는 오픈소스 라이선스로 무료 사용, 수정, 배포를 허용합니다.

질문: Windows에서 Cadenya CLI를 설치하려면 어떤 방법이 있나요?
답변: Windows에서는 Chocolatey 패키지 관리자를 사용하여 ‘choco install cadenya’ 명령으로 설치할 수 있습니다.

시스템 요구사항

별도의 시스템 요구사항이 등록되지 않았습니다.

Cadenya CLI

소개