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