CLI
axhub CLI 설치·전역 옵션·출력·종료 코드, 그리고 명령 전체 레퍼런스 길잡이
axhub는 터미널·CI·에이전트에서 axhub를 다루는 공식 CLI예요.
모든 명령·플래그는 axhub --json-schema로도 받을 수 있어요. 이 레퍼런스는 그 출력에서 자동 생성돼요 — 즉 설치된 CLI와 항상 일치해요. 끝단 디테일은 axhub <명령> --help가 늘 최신이에요.
설치
curl -fsSL https://cli.axhub.ai/install.sh | bash
axhub --versionirm https://cli.axhub.ai/install.ps1 | iex
axhub --version전역 옵션
어느 명령에나 붙일 수 있는 옵션이에요. 대부분 환경변수로도 줄 수 있어요.
| 옵션 | 설명 |
|---|---|
--profile <이름> | 사용할 프로필 (AXHUB_PROFILE) |
--tenant <회사> | 대상 회사(tenant) 지정 (AXHUB_TENANT) |
--json | 결과를 JSON으로 출력 (AXHUB_JSON) |
-y, --yes | 확인 프롬프트 자동 승인 (AXHUB_YES) |
--no-input | 대화형 입력 비활성 — 에이전트·CI용 (AXHUB_NO_INPUT) |
--no-keychain | OS 키체인 대신 파일 자격증명 사용 (AXHUB_NO_KEYCHAIN) |
--endpoint <URL> | API 엔드포인트 (AXHUB_ENDPOINT) |
--timeout <기간> | 요청 타임아웃, 예: 30s (AXHUB_TIMEOUT, 기본 30s) |
--idempotency-key <UUID> | 재시도 안전을 위한 멱등 키 (AXHUB_IDEMPOTENCY_KEY) |
--no-color | 색 출력 끄기 (AXHUB_NO_COLOR) |
-v, --debug | 디버그 로그 (AXHUB_DEBUG) |
출력 형식
--json을 주면 모든 결과가 같은 봉투(envelope) 형태로 나와요 — 성공이면 data, 실패면 error.
{ "data": { /* ... */ } }
{ "error": { "category": "...", "code": "...", "request_id": "...", "hint": "..." } }에이전트는 사람이 읽는 메시지 대신 error.code와 아래 종료 코드로 분기하세요.
종료 코드
| 코드 | 의미 | 대처 |
|---|---|---|
0 | 성공 | — |
1 | 일반 오류 | 로컬 I/O 등 |
2 | 잘못된 사용법 | 인자·플래그 확인 |
4 | 인증 필요 | axhub auth login |
5 | 리소스 없음 | 대상 id/slug 확인 |
6 | 요청 제한 | 잠시 후 재시도 |
7 | API 오류 | 메시지·request_id 확인 |
8 | 회사(tenant) 범위 오류 | 활성 회사 확인 |
9 | 충돌 | 이미 존재/처리됨 — 인자 변경 |
10 | 타임아웃 | 재시도 |
11 | dry-run 차단 | --execute 추가 |
12 | 도메인 차단 | 초대 이메일 도메인 정책 위반 |
13 | 초대 만료 | 새 초대 발송 |
명령 레퍼런스
각 페이지에 서브명령과 플래그가 전부 있어요.