CLI

axhub CLI의 설치 · 전역 옵션 · 종료 코드와 쓸 수 있는 명령 전체 목록

axhub는 터미널 · CI · 에이전트에서 axhub를 다루는 공식 CLI예요. 설치 방법과 전역 옵션, JSON 출력 봉투, 종료 코드처럼 모든 명령에 공통으로 적용되는 규칙이 이 페이지에 모여 있어요. 그다음 쓸 수 있는 명령 전부를 목적별로 묶어 늘어놨어요. CLI를 처음 설치하고 첫 앱까지 올려보려면 퀵스타트를 먼저 따라 해보세요.

모든 명령 · 플래그는 axhub --json-schema로도 받을 수 있어요. 이 레퍼런스는 그 출력에서 자동 생성돼요(현재 기준 v0.30.0). 끝단 디테일은 axhub <명령> --help가 늘 최신이에요.

설치

macOS / Linux

curl -fsSL https://cli.axhub.ai/install.sh | bash
axhub --version

Windows PowerShell

irm https://cli.axhub.ai/install.ps1 | iex
axhub --version

전역 옵션

어느 명령에나 붙일 수 있는 옵션이에요. 대부분 환경변수로도 줄 수 있어요.

옵션	설명
`--profile <이름>`	사용할 프로필 (`AXHUB_PROFILE`)
`--tenant <회사>`	대상 회사(tenant) 지정 (`AXHUB_TENANT`)
`--json`	결과를 JSON으로 출력 (`AXHUB_JSON`)
`--field-expr <표현식>`	JSON 출력에서 jq 호환 표현식으로 값만 추출
`--field-expr-json <표현식>`	추출 결과를 compact JSON으로 출력
`-y, --yes`	비파괴 확인 프롬프트 자동 승인 (`AXHUB_YES`)
`--no-input`	대화형 입력 비활성 — 에이전트 · CI용 (`AXHUB_NO_INPUT`)
`--non-interactive`	완전 비대화 모드 (`AXHUB_NON_INTERACTIVE`)
`--no-keychain`	OS 키체인 대신 파일 자격증명 사용 (`AXHUB_NO_KEYCHAIN`)
`--token-file <경로>`	OAuth 토큰 파일 경로 (`AXHUB_TOKEN_FILE`)
`--api-key-file <경로>`	PAT(API key) 파일 경로 (`AXHUB_API_KEY_FILE`)
`--config <경로>`	CLI 설정 파일 경로 (`AXHUB_CONFIG`)
`--endpoint <URL>`	API 엔드포인트 (`AXHUB_ENDPOINT`)
`--insecure-endpoint`	비 HTTPS 엔드포인트 허용 — 개발 · 테스트 전용 (`AXHUB_INSECURE_ENDPOINT`)
`--timeout <기간>`	요청 타임아웃, 예: `30s` (`AXHUB_TIMEOUT`)
`--idempotency-key <UUID>`	재시도 안전을 위한 멱등 키 (`AXHUB_IDEMPOTENCY_KEY`)
`--agent-error-guide`	에이전트용 에러 가이드를 stderr로 출력
`--otlp-endpoint <URL>`	옵트인 에이전트 텔레메트리용 OTLP 수집기 (`AXHUB_OTLP_ENDPOINT`)
`--completions <셸>`	자동완성 스크립트 출력 (`completion` 서브명령과 동일)
`--json-schema`	전체 CLI 표면을 JSON 스키마로 내보내기 — 에이전트 · CI 드리프트 체크용
`--no-color`	색 출력 끄기 (`AXHUB_NO_COLOR`)
`--trace`	요청 트레이스 출력
`-v, --debug`	디버그 로그 (`AXHUB_DEBUG`)
`--version`	버전 출력

플래그와 짝이 없는 환경변수

환경변수	설명
`AXHUB_OUTPUT=json`	`--json`과 동일
`AXHUB_API_KEY`	PAT 값 직접 주입 (파일 대신)
`AXHUB_DISABLE_AUTOUPDATE=1`	CLI 자동 업데이트 확인 끄기
`AXHUB_ALLOW_UNSIGNED=1` · `AXHUB_REQUIRE_COSIGN=1`	업데이트 서명 검증 완화/강제 (둘 다 켜면 `64`)
`AXHUB_USE_KEYCHAIN=1`	`--no-input`에서도 OS 키체인 강제 사용
`AXHUB_INSTALL_DIR`	installer 설치 경로 지정
`AXHUB_LOG`	트레이싱 로그 필터

AXHUB_TOKEN이라는 환경변수는 읽지 않아요. 토큰은 --token-file(AXHUB_TOKEN_FILE) 또는 PAT(AXHUB_API_KEY)로 주입하세요.

출력 형식

--json을 주면 모든 결과가 같은 봉투(envelope) 형태로 나와요. status는 ok · error · dry_run 셋 중 하나예요 — 미리보기(dry-run)는 성공이 아니라 dry_run으로 구분돼요.

{ "schema_version": "1", "status": "ok", "data": { /* ... */ } }
{ "schema_version": "1", "status": "error", "error": { "code": "...", "subcode": "...", "fields": [], "resource": "...", "doc_url": "..." } }

에이전트는 사람이 읽는 메시지 대신 error.code · error.subcode와 아래 종료 코드로 분기하세요.

종료 코드

코드	의미	대처
`0`	성공	—
`1`	일반 오류	로컬 I/O 등
`2`	내부 초기화 실패 (드묾)	재시도 · 진단 — 잘못된 플래그 · 명령은 `2`가 아니라 `64`로 나와요
`4`	인증 필요	`axhub auth login`
`5`	리소스 없음	대상 id/slug 확인
`6`	요청 제한	잠시 후 재시도
`7`	API 오류	메시지 · request_id 확인
`8`	회사(tenant) 범위 오류	활성 회사 확인
`9`	충돌	이미 존재/처리됨 — `error.subcode`로 분기
`10`	타임아웃	재시도
`11`	dry-run 차단	`--execute` 추가
`12`	도메인 차단	초대 이메일 도메인 정책 위반
`13`	초대 만료	새 초대 발송
`14`	업데이트 digest 불일치	변조 신호 — 설치 중단, 재설치
`15`	바이너리 교체 실패	`update apply` 마지막 단계 실패 — 재시도 · 진단
`64`	CLI 측 사용법 · 검증 실패	입력 수정 후 재시도
`66`	업데이트 정책 차단	`error.subcode`로 다운그레이드/cosign 구분

명령 전체 목록

v0.30.0 기준으로 쓸 수 있는 명령 전부예요. 목적별로 묶었고, 각 줄이 실제로 칠 수 있는 명령이에요. 플래그는 axhub <명령> --help나 아래 묶음별 상세에 있어요.

바꾸는 명령은 미리보기가 기본이에요. 설명에 "dry-run"이 있는 명령은 그냥 실행하면 무엇이 바뀔지만 보여주고 멈춰요. 실제로 반영하려면 --execute를 붙여요.

로그인 · 내 계정

명령	하는 일
`axhub auth login`	OAuth 디바이스 플로우로 로그인
`axhub auth logout`	로그아웃하고 저장된 자격증명 삭제
`axhub auth status`	지금 인증 상태 보기
`axhub auth whoami`	지금 로그인한 사용자 보기
`axhub auth refresh`	저장된 OAuth 액세스 토큰 갱신
`axhub auth pat issue`	개인 액세스 토큰(PAT) 발급
`axhub auth pat list`	내 PAT 목록
`axhub auth pat revoke`	PAT 폐기
`axhub auth pat rotate`	PAT 교체 — 폐기하고 새로 발급
`axhub auth pat use`	PAT를 로컬 기본 자격증명으로 저장
`axhub auth pat unset`	저장된 PAT 해제
`axhub auth pat whoami`	이 PAT가 누구로 인증되는지 보기
`axhub auth oauth revoke`	OAuth 토큰 폐기
`axhub auth oauth client`	OAuth 클라이언트 관리
`axhub auth oauth consent`	OAuth 동의 관리
`axhub auth idp list`	회사 IdP(SSO 로그인 설정) 목록
`axhub auth idp create`	IdP 설정 만들기
`axhub auth idp update`	IdP의 바꿀 수 있는 값 수정
`axhub auth idp enable` · `disable`	IdP 켜기 · 끄기
`axhub auth idp delete`	꺼져 있는 IdP 삭제
`axhub auth idp providers`	지원하는 IdP 종류 목록
`axhub auth idp test`	IdP 설정이 실제로 되는지 시험
`axhub profile add` · `list` · `current` · `use` · `remove`	로컬 CLI 프로필 관리
`axhub config explain`	지금 설정이 어디서 온 값인지 설명
`axhub doctor`	설정 · 인증 · 백엔드 연결을 로컬에서 진단

회사(테넌트) · 사람

명령	하는 일
`axhub tenants whoami`	활성 회사에서 내 멤버십과 역할
`axhub tenants list` · `get`	내가 속한 회사 목록 · 한 회사 상세
`axhub tenants create` · `update` · `delete` · `restore`	회사 만들기 · 수정 · 삭제 · 복구
`axhub tenants groups list` · `create` · `rename` · `delete`	회사 그룹(팀) 관리
`axhub tenants scim connection`	SCIM 연동 상태 보기
`axhub tenants scim issue-token` · `revoke-token`	SCIM 토큰 발급 · 폐기
`axhub tenants google-directory`	Google Workspace 조직도 연동 관리
`axhub tenants directory-sync`	연동된 조직도를 지금 동기화
`axhub tenants invite-links`	초대 링크 만들기 · 목록 · 철회
`axhub tenants icon set` · `clear` · `sign`	회사 아이콘 설정 · 해제 · 업로드 URL 발급
`axhub tenants billing summary` · `entitlements`	예상 청구 요약 · 한도
`axhub tenants billing subscription` · `seats` · `payment-method` · `payments`	요금제 · 좌석 · 결제수단 · 결제 이력
`axhub tenants billing credits`	종량제 크레딧 조회 · 충전
`axhub tenants agents hermes`	회사의 hermes 사용 권한 관리
`axhub members list` · `me` · `resolve`	멤버 목록 · 내 멤버십 · 이메일로 찾기
`axhub members set-role`	멤버 역할 바꾸기
`axhub members deactivate` · `reactivate`	멤버 비활성화 · 재활성화
`axhub members move-group` · `restore-scim`	그룹 배치 바꾸기 · 조직도 연동으로 되돌리기
`axhub members assign-seat` · `unassign-seat`	유료 좌석 배정 · 회수
`axhub members directory` · `org-directory`	그룹 배치가 붙은 명단 · 조직도(읽기 전용)
`axhub invitations send` · `bulk`	초대 보내기 · 여러 명 한꺼번에
`axhub invitations list` · `cancel` · `resend` · `accept`	초대 목록 · 취소 · 재발송 · 수락

앱

명령	하는 일
`axhub apps list` · `mine` · `owned` · `received` · `workspace`	앱 목록 — 접근 가능 · 내 것 · 받은 것 · 워크스페이스
`axhub apps get` · `search` · `discover`	앱 상세 · 검색 · 공개 앱 둘러보기
`axhub apps create` · `fork` · `update`	앱 만들기 · 복제 · 메타데이터 수정
`axhub apps check-availability`	앱 주소(slug)가 비어 있는지 확인
`axhub apps bootstrap` · `bootstrap-status`	템플릿 · 저장소로 앱 부트스트랩 · 진행 상태
`axhub apps templates list`	쓸 수 있는 부트스트랩 템플릿 목록
`axhub apps detect`	GitHub 저장소의 빌드 설정 감지 (읽기 전용)
`axhub apps suspend` · `resume`	앱 일시정지 · 재개
`axhub apps archive` · `reactivate`	앱 보관 · 보관 해제
`axhub apps delete` · `purge`	앱 삭제 · 영구 삭제
`axhub apps members`	앱 멤버 목록
`axhub apps co-owners`	공동 소유자 관리 (목록 · 추가 · 제거)
`axhub apps ownership transfer`	대표 소유권 넘기기 — 되돌릴 수 없어요
`axhub apps git connect` · `status` · `update` · `disconnect`	GitHub 저장소 연결 · 상태 · 브랜치 변경 · 해제
`axhub apps domains list` · `add` · `remove` · `verify`	커스텀 도메인 목록 · 등록 · 해제 · DNS 재확인
`axhub apps storage status` · `enable`	앱 스토리지 상태 · 프로비저닝
`axhub apps storage ls` · `get-url` · `rm`	파일 목록 · 다운로드 URL 발급 · 삭제
`axhub apps raw-db`	앱 전용 Postgres 데이터베이스 관리
`axhub apps static site` · `releases` · `deploy` · `auth`	정적 호스팅 — 사이트 설정 · 릴리스 · 배포 · 보호 인증
`axhub apps resource-presets`	백엔드 리소스 프리셋 카탈로그
`axhub apps inspection-consent`	코드 점검(LLM 리뷰) 동의 보기 · 설정
`axhub apps sign-icon-upload`	앱 아이콘 업로드용 서명 URL 발급
`axhub init`	현재 폴더에 `axhub.yaml` 만들기
`axhub manifest`	`axhub.yaml` 파싱 · 검증
`axhub open`	앱이나 리소스를 브라우저로 열기
`axhub categories list` · `get` · `create` · `update` · `delete`	앱 카테고리 관리
`axhub publish`	앱 공개 신청 보내기
`axhub review list` · `get` · `approve` · `reject` · `history`	공개 신청 심사 — 목록 · 상세 · 승인 · 반려 · 이력
`axhub github accounts list`	AxHub가 볼 수 있는 GitHub 계정 · 조직
`axhub github installations repos`	GitHub App 설치에 딸린 저장소 목록
`axhub github repo create`	연결한 GitHub 계정으로 저장소 만들기
`axhub github link`	브라우저 없이 디바이스 코드로 GitHub 연결
`axhub github complete`	GitHub App 설치 콜백 마무리

배포

명령	하는 일
`axhub deploy create`	배포 시작
`axhub deploy status`	최근 배포 상태
`axhub deploy verify`	특정 배포가 정말 성공했는지 검증
`axhub deploy watch`	끝날 때까지 배포 지켜보기
`axhub deploy list` · `releases`	배포 이력 · 릴리스 이력
`axhub deploy logs`	배포 로그 보기
`axhub deploy cancel`	진행 중인 배포 취소
`axhub deploy rollback`	`--from-deployment`으로 지정한 배포로 되돌리기
`axhub deploy fleet`	여러 앱을 한꺼번에 배포
`axhub deploy staging enable` · `disable`	스테이징 환경 켜기 · 끄기
`axhub deploy promote-preflight`	운영 반영 전 바뀔 내용 미리보기
`axhub deploy promote` · `promote retry`	운영 반영 · 실패한 반영 재시도
`axhub deploy scan`	배포의 보안 스캔 리포트
`axhub deploy scan report-false-positive`	스캔 결과 하나를 오탐으로 신고
`axhub deploy diagnose`	배포된 앱의 롤아웃 건강 상태 진단
`axhub deploy doctor`	배포 준비가 됐는지 진단
`axhub deploy git configure` · `connect` · `disconnect` · `status`	배포용 git 연결 설정 · 연결 · 해제 · 상태
`axhub deploy codes`	배포 상태 코드와 뜻 목록
`axhub deploy explain`	설정 · 인증 · 대상 앱을 어떻게 정했는지 설명

데이터베이스 · 환경변수

명령	하는 일
`axhub tables list` · `get`	동적 테이블 목록 · 상세
`axhub tables create` · `drop`	테이블 만들기 · 지우기
`axhub tables check-availability` · `column-types`	테이블 이름 사용 가능 여부 · 쓸 수 있는 컬럼 타입
`axhub tables columns add` · `remove`	컬럼 추가 · 제거
`axhub tables rows insert` · `update` · `delete`	행 넣기 · 고치기 · 지우기
`axhub tables grants list` · `issue` · `revoke`	테이블 접근 권한 목록 · 부여 · 회수
`axhub tables db-list` · `db-rows`	앱 전용 DB의 실제 테이블 · 행 보기 (OAuth 필요)
`axhub data list` · `count` · `get`	`/data` API로 행 조회 · 개수 · 하나 보기
`axhub data insert` · `update` · `delete`	행 넣기(`--batch`로 JSONL) · 고치기 · 지우기
`axhub env list` · `get`	환경변수 목록 · 값 하나
`axhub env set` · `update` · `delete`	환경변수 만들기 · 수정 · 삭제
`axhub env set-staging-value`	스테이징 전용 값 설정

커넥터 · 게이트웨이 · 권한

명령	하는 일
`axhub connectors list` · `show` · `mine`	커넥터 목록(관리자) · 상세 · 내가 쓸 수 있는 것
`axhub connectors create` · `update` · `delete`	커넥터 등록 · 수정 · 삭제
`axhub connectors test-connection`	저장된 자격증명으로 실제 연결 시험
`axhub connectors discover` · `resources`	리소스 탐색 실행 · 탐색된 리소스 트리
`axhub connectors app-db`	앱 전용 DB를 커넥터로 열기
`axhub connectors google start` · `finalize`	Google Drive OAuth 시작 · 마무리
`axhub gateway session start` · `end`	게이트웨이 세션 시작 · 종료 (8시간)
`axhub gateway query`	세션으로 안전 SQL 조회
`axhub gateway invoke` · `document-invoke` · `file-invoke`	REST · 문서형 · 파일 스토리지 호출
`axhub authz subjects list` · `show` · `create`	권한 주체(그룹 · 조직 단위) 관리
`axhub authz presets list` · `show` · `create` · `update` · `delete`	권한 프리셋 관리
`axhub authz policies list` · `show` · `create` · `update` · `delete`	접근 정책(행 필터 · 컬럼 허용/마스킹) 관리
`axhub authz grants list` · `show` · `create` · `revoke` · `mine`	데이터 접근 권한 부여 · 회수 · 내 권한
`axhub authz grants set-policies`	권한에 붙은 정책 묶음 교체
`axhub access`	앱 접근 권한 — 부여 · 회수 · 목록 · 협업자 초대
`axhub sites create` · `list` · `show`	사설망 site 등록 · 목록 · 상세
`axhub sites rotate-token` · `delete`	site 토큰 교체 · 삭제

AI · 알림 · 웹훅

명령	하는 일
`axhub axrouter status`	회사별 AI 사용 가능 여부와 내 동의 상태
`axhub axrouter monitor`	Claude Code 프롬프트 기록 켜기 (`--off`로 끄기)
`axhub axrouter consent` · `revoke-consent`	본문 수집 동의 · 철회
`axhub axrouter revoke`	등록 해제하고 기록도 끄기
`axhub axrouter keys issue` · `list` · `revoke`	AXRouter 가상 API 키 발급 · 목록 · 폐기
`axhub sdk search`	SDK 지식 의미 검색
`axhub sdk recipe`	SDK 레시피 렌더 — 앱에 맞춰 치환
`axhub sdk validate`	파일 하나의 SDK 사용법 정적 검증
`axhub notifications list` · `read`	알림함 조회 · 읽음 처리
`axhub notifications prefs list` · `set`	종류×채널 수신 설정 보기 · 바꾸기
`axhub relay list` · `create` · `delete`	수신 웹훅 엔드포인트 목록 · 생성 · 폐쇄
`axhub relay rotate-key` · `deliveries` · `replay`	키 교체 · 전달 이력 · 재전송
`axhub agents hermes status` · `up` · `down`	내 hermes 인스턴스 상태 · 시작 · 삭제

도구 · 진단

명령	하는 일
`axhub infra usage` · `usage-series`	회사 인프라 사용량 · 앱별 사용량 시계열
`axhub update check` · `apply`	새 버전 확인 · 설치
`axhub whatsnew`	릴리스 노트
`axhub completion bash` · `zsh` · `fish` · `powershell`	셸 자동완성 스크립트 출력
`axhub cache clear`	로컬 스키마 캐시 비우기
`axhub dev`	로컬 개발 도우미
`axhub feedback -m "<메시지>"`	CLI 실패를 진단 정보와 함께 신고 (`--dry-run`으로 미리보기)
`axhub support diagnose`	지원 티켓용 진단 번들 수집 (민감정보 마스킹)
`axhub tui`	인터랙티브 터미널 대시보드

axhub axrouter keys는 OAuth 로그인(axhub auth login)이 필요해요. v0.28.0부터 RFC 8693 token-exchange로 10분짜리 워크스페이스 고정 콘솔 토큰을 얻는 구조라, PAT(AXHUB_API_KEY) 단독으로는 쓸 수 없어요. 둘 다 있으면 저장된 OAuth 토큰을 자동으로 써요.

묶음별 상세

플래그 · 인자 · 응답까지 필요하면 아래를 보세요. 사이드바에는 없고 여기서만 열려요.

인증 · 계정

auth · profile · tenants · config · doctor · update

앱

apps(static · storage · domains · co-owners · raw-db 포함) · init · github · open · categories · review · publish

배포

deploy — 상태 · 로그 · 롤백 · staging · promote · verify · scan

데이터베이스 · 환경변수

tables db-list · db-rows · env

게이트웨이 · 커넥터

connectors(app-db 포함) · gateway 세션 · 안전 쿼리

거버넌스 · 접근

access · members · invitations · authz(접근 정책 포함)

상세 페이지는 v0.28.0 기준이에요 — 플래그 수준의 변화는 axhub <명령> --help가 늘 최신이에요.

이전 버전에서 옮겨오기

제거된 명령 — axhub resources · catalog · status · engines는 v0.24 기준 더 이상 없어요 (64로 거부). 카탈로그 · 리소스 탐색은 connectors resources · gateway로, 배포 상태는 deploy status로 옮겨 가세요.
위 목록에 없는 명령 — admin · audit · cost · email-domains처럼 도움말에서도 숨겨진 플랫폼 관리자 · 내부 명령이 몇 개 있어요. 여전히 동작하지만 공개 레퍼런스에서는 다루지 않아요.