CLI 설치

공개 CLI 베타는 Apple Silicon macOS를 지원하며 Ubuntu x86_64 미리보기도 제공합니다. macOS 바이너리는 체크섬 검증과 Developer ID 서명을 적용하지만 공증된 앱 번들이나 유니버설 바이너리는 아닙니다. Linux 배포는 고정된 배포자 SSH 키로 체크섬 서명을 검증합니다. 소스 저장소는 비공개로 유지하고 검토된 바이너리만 공개 c6shq/tap 경계로 배포합니다.

macOS 준비 사항

• Apple Silicon Mac
• 권장 Formula 방식에는 Homebrew, 독립 설치 방식에는 curl과 sh

macOS에서 Homebrew로 설치

정규화된 Formula 이름을 사용하세요. Homebrew가 공개 tap을 추가하고 선택한 Formula만 신뢰합니다.

brew install c6shq/tap/c6s-cli

Formula는 변경되지 않는 버전별 URL과 정확한 SHA-256 체크섬을 사용합니다.

macOS에서 Homebrew 없이 설치

독립 설치기는 최신 공개 바이너리 미러를 내려받고 checksums.txt와 아카이브 구조를 검증한 뒤 ~/.local/bin/c6s를 원자적으로 교체합니다.

curl -fsSL https://c6s.whitekiwi.link/install.sh | sh

~/.local/bin이 PATH에 없다면 사용하는 셸의 일반적인 설정 방식으로 추가하세요. 설치기는 셸 시작 파일을 수정하지 않습니다. 버전을 고정하거나 다른 설치 디렉터리를 선택할 수도 있습니다.

curl -fsSL https://c6s.whitekiwi.link/install.sh | \
  C6S_VERSION=v0.11.4 C6S_INSTALL_DIR="$HOME/.local/bin" sh

Ubuntu x86_64에서 설치 (미리보기)

평소 사용하는 Ubuntu GNOME 데스크톱 로그인 세션과 잠금이 해제된 영구 기본 키링을 사용하세요. CLI에는 해당 사용자의 기존 D-Bus 세션과 Secret Service가 필요합니다. 이 서비스가 없는 SSH·컨테이너 환경에서는 자격 증명을 저장할 수 없습니다.

sudo apt install curl ca-certificates python3 openssh-client
curl -fsSL https://github.com/c6shq/homebrew-tap/releases/download/c6s-linux-latest/install-linux.sh | sh
export PATH="$HOME/.local/bin:$PATH"
c6s version
c6s channel
c6s protocol verify
c6s doctor --json

설치기는 배포자 서명, 아카이브 SHA-256, Linux x86_64 실행 파일과 버전·채널을 검증한 뒤 ~/.local/bin/c6s를 원자적으로 교체합니다. 심볼릭 링크 대상은 거부합니다. 셸 시작 파일, 계정, 금고 설정은 수정하지 않습니다. 필요하면 PATH 줄을 사용하는 셸 설정에 추가하세요. 라이선스 고지는 ${XDG_DATA_HOME:-$HOME/.local/share}/c6s/c6s에 설치됩니다.

버전을 고정하려면 다음 명령을 사용하세요.

curl -fsSL https://github.com/c6shq/homebrew-tap/releases/download/c6s-linux-v0.11.5/install-linux.sh -o install-linux.sh
C6S_VERSION=v0.11.5 sh install-linux.sh

Linux 미리보기 바이너리는 기존 stable CLI 채널과 프로덕션 서버를 사용합니다. 플랫폼 미리보기는 모든 Ubuntu 버전 지원이나 실제 계정·승인·재실행 거부 검증을 완료했다는 뜻이 아닙니다. Linux ARM64 패키지는 제공하지 않습니다. 공개 릴리스에는 서명된 체크섬, SBOM, 배포자가 서명한 빌드 출처 문서가 포함됩니다. 배포자 키 지문은 SHA256:Esv3OhmqQzqPeWRzSiHlnxmaq/3KWXMtjzte/2n2TIs입니다.

Linux는 기존 Secret Service가 저장하는 내보낼 수 있는 소프트웨어 키를 사용하며 하드웨어·생체인증 보호를 제공하지 않습니다. doctor는 세션 메타데이터만 읽으며 계정 접근을 검증하지 않습니다. secret_service_locked가 나오면 같은 데스크톱 세션에서 기존 키링의 잠금을 해제한 뒤 다시 실행하세요. CLI는 키링을 만들거나 잠금을 해제하지 않으며 평문 저장으로 대체하지 않습니다.

확인

c6s version
c6s protocol verify

로그인하고 이 CLI 기기 등록하기

프로덕션 빌드에는 계정 없는 데모가 없습니다. 초대된 계정으로 로그인하고 CLI 기기를 등록한 다음, 기기별로 래핑된 Personal 금고 키를 연결하세요.

c6s login --provider google
c6s whoami
c6s device enroll
c6s device remote-status
c6s vault connect
c6s item list --remote

새 CLI 기기는 먼저 신뢰된 iPhone 또는 승인된 복구 경로에서 승인을 받아야 합니다. 이 명령들은 기기 개인키, 금고 키 또는 시크릿 값을 출력하지 않습니다.

로컬 기기 키 초기화

c6s device setup
c6s device status

macOS에서는 독립된 암호화·서명 키를 로그인 키체인의 기기 전용, 잠금 해제 시 접근 클래스로 저장합니다. 명령 출력에는 공개 지문과 로컬 표시 식별자만 나옵니다.

Linux에서는 잠금이 해제된 기존 기본 Secret Service 컬렉션을 사용합니다. 저장 시 보호는 서비스가 담당하며 사용 중 소프트웨어 키는 CLI 메모리에 들어갑니다. 같은 사용자 권한의 프로세스와 관리자는 이 보호 경계에 포함되지 않습니다.

암호화된 로컬 금고 사용

로컬 Personal 금고를 초기화하고 아이템을 만듭니다.

c6s vault init
c6s item create --kind api_credential --title "Build service" --json

반환된 아이템 ID를 복사하세요. 시크릿 값은 프로세스 인자에 남지 않도록 표준 입력으로만 전달합니다.

printf %s "$TOKEN" | \
  c6s item set ITEM_ID --field Token --value-stdin
c6s item list
c6s item inspect ITEM_ID

macOS에서는 무작위 루트 키를 기기 전용·잠금 해제 시 접근 보호로 Keychain에 저장합니다. Linux에서는 앞서 설명한 소프트웨어 키 보호를 적용하는 기존 Secret Service 컬렉션에 저장합니다. 로컬 파일에는 메타데이터와 시크릿의 독립된 인증 암호문만 저장되며 제목, 라벨, 값은 평문으로 남지 않습니다. 목록·검사·변경·MCP 출력에는 값이 포함되지 않습니다. 원문 출력이 꼭 필요할 때만 c6s item reveal ITEM_ID --field Token --show를 사용하고 표준 출력을 시크릿으로 취급하세요.

안정 CLI는 여러 계정 프로필 인증, CLI 기기 등록, 기기별로 래핑된 Personal 금고 키 연결, 암호화된 원격 아이템 메타데이터 확인, 한 번만 승인하는 실행 요청을 지원합니다. 설치 후 CLI 명령 안내를 확인하세요. 로컬 전용 금고 명령은 호스팅 Personal 금고와 분리되며 자동으로 합쳐지지 않습니다.

업데이트

Homebrew 설치는 brew upgrade c6s-cli를 실행하세요. 독립 설치는 해당 플랫폼의 설치기를 다시 실행하면 검증 후 실행 파일을 원자적으로 교체합니다.