문서

CLI 레퍼런스

CLI는 반복 가능한 터미널 운영을 원하는 팀을 위해 호스티드 API 표면을 그대로 반영합니다.

설치와 인증

bashcd sdk/cli
pip install -e .

schift auth login
schift auth status

설정 우선순위

SCHIFT_API_KEY가 ~/.schift/config.json보다 우선합니다. SCHIFT_API_URL이 기본 https://api.schift.io/v1보다 우선합니다.

명령 그룹

그룹	명령	메모
`auth`	`login`, `logout`, `status`	환경변수를 쓰지 않으면 `~/.schift/config.json`에 키 저장
`catalog`	`list`, `get MODEL_ID`	모델 메타데이터 조회
`embed`	`schift embed TEXT --model ...`, `schift embed batch --file texts.jsonl --model ... [--output out.jsonl]`	배치 입력은 `text` 필드를 가진 JSONL
`db`	`create`, `list`, `stats`	호스티드 컨렉션 관리
`query`	`query TEXT --collection ... [--top-k] [--model] [--threshold]`	자연어 검색
`bench`	`bench --source ... --target ... --data eval.jsonl [--top-k]`	로컬 파일 경로를 API로 전달
`migrate`	`fit --source ... --target ... [--sample]`, `run --projection ... --db ... [--dry-run] [--batch-size]`	실제 DB 수정 전 `--dry-run` 권장
`usage`	`usage [--period]`	계정 요약과 모델별 사용량

엔드투엔드 예시

bashschift catalog list
schift embed "분기 매출 보고서" --model openai/text-embedding-3-large
schift db create finance-docs --dim 3072
schift query "회의 요약" --collection finance-docs --top-k 5
schift bench --source openai/text-embedding-3-small --target google/gemini-embedding-001 --data ./eval.jsonl
schift migrate fit --source openai/text-embedding-3-small --target google/gemini-embedding-001 --sample 0.1
schift migrate run --projection proj_abc123 --db pgvector://user:pass@localhost/app --dry-run

배치 임베딩 입력은 줄마다 text 필드가 있는 JSON 객체여야 합니다.
migrate run 출력에서는 비밀번호를 가려주지만, 실제 자격 증명은 셸 히스토리에 남기지 마세요.
CLI는 Rich 기반 출력이라서 표와 요약 패널이 사람 읽기용으로 설계되어 있습니다.