alex CLI
주요 명령
alex 명령 레퍼런스와 출력 규약.
출력 규약
- 기본 stdout 은 단일 JSON.
--pretty로 들여쓰기. 빈 응답(204/빈 200)도null로 항상 유효한 JSON. - 에러는 stderr 에
{"error":{"code","message","hint"}}—hint가 다음 행동을 안내. - 종료 코드:
0성공 ·2사용법 ·3인증 ·4없음 ·1기타.
명령
흐름은 보통 찾기 → 가져오기 → 실행 순서입니다.
| 명령 | 설명 |
|---|---|
alex auth login | whoami | logout | 로그인 / 현재 사용자 / 로그아웃 |
alex rec ls [--cursor --limit --tag --all] | 기록 목록 (커서 페이지네이션, --all 은 전체 수집·중복 제거) |
alex rec search <query> | 기록 전문검색 |
alex rec get <id> | 기록 상세 (JSON) |
alex rec status <id> | 경량 상태/진행률 (폴링용) |
alex rec upload <file> [--wait] | 오디오 업로드, --wait 면 완료까지 대기 |
alex rec watch <id> | 진행률 SSE 스트림 (JSON 라인) |
alex rec transcript <id> [--text] | 전사 결과 (JSON 또는 화자: 발화) |
alex rec notes <id> [--ai] | 노트 (--ai 면 AI 요약만) |
alex rec summarize <id> | AI 요약 재생성 |
alex rec chat <id> "질문" | 기록 내용에 대해 Alex AI 채팅 |
alex rec retry <id> | 실패한 단계부터 재시도 |
alex rec rm <id> --yes | 기록 삭제 |
alex templates | tags | 요약 템플릿 / 태그 목록 (읽기 전용) |
자주 쓰는 명령은 rec 없이 호출하는 alias 가 있습니다 — alex ls · alex get · alex upload · alex chat.
alex rec upload meeting.m4a --wait # 완료까지 대기 후 상세 출력
alex rec transcript <id> --text # 화자: 발화
alex rec chat <id> "핵심 결정사항만 정리해줘"각 명령의 전체 옵션은 alex <명령> --help 로 확인하세요 (예: alex rec upload --help →
--skip-summary · --template · --timezone · --force).
summarize/chat 은 --data <json|@file|@-> 로 raw 바디 주입도 지원합니다.
모델은 CLI 에서 고를 수 없습니다 — admin 이 tier별로 설정한 기본 모델을 그대로 사용합니다.