앱

앱 생성 · 조회 · 관리 · 정적 호스팅 · GitHub 연동 · 심사 · 공개 명령

앱 하나의 생애 전체 — 생성 · 조회 · 설정 변경 · GitHub 연동 · 파일 스토리지 · 커스텀 도메인 · 소유권 · 공개 심사 — 를 CLI로 다룰 때 이 페이지를 봐요. 새 앱은 apps bootstrap(템플릿 + 저장소 + 첫 배포) 또는 apps create로 시작해요. 공개 범위 · 초대 같은 "누가 이 앱을 쓸 수 있나"의 개념 정리는 접근 제어 가이드에서 먼저 확인하면 좋아요. 표의 플래그 설명은 CLI 도움말 원문 그대로예요.

`axhub apps`

앱을 만들고 조회 · 관리해요.

`axhub apps archive`

앱을 보관(archive)해요.

플래그	타입	설명	기본값
`<app>`	string (인자)	App slug or ID to operate on.	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—

`axhub apps bootstrap`

템플릿으로 앱을 한 번에 만들어요 (저장소 생성 + 첫 배포).

플래그	타입	설명	기본값
`--device-code`	string	Resume an already-issued GitHub OAuth device code (env: `AXHUB_GITHUB_DEVICE_CODE`)	—
`--dry-run`	boolean	Dry-run preview is the default. Pass --execute to create backend app + GitHub repo + deploy	`true`
`--execute`	boolean	Execute the bootstrap saga	—
`--github-owner`	string	GitHub owner or organization where the repository will be created	—
`--installation-id`	integer	GitHub App installation id	—
`--name`	string	New app display name	—
`--repo-name`	string	Repository name to create in GitHub	—
`--repo-private`	boolean	Create a private repository. Default unless `--repo-public` is passed	`true`
`--repo-public`	boolean	Create a public repository	—
`--resume-last`	boolean	Resume the latest locally cached `GitHub` Device Flow for this profile	—
`--slug`	string	New app slug	—
`--subdomain`	string	New app subdomain label	—
`--template`	string	Template UUID or built-in alias (`react`, `nextjs`, `astro`)	—
`--tenant`	string	Tenant slug or id. Defaults to the active tenant when omitted	—
`--wait-approval`	string	Keep waiting for the user's GitHub approval inside this one command, up to the given duration (6s–10m; e.g. 90s). Without it the resume polls once and exits. Use it instead of re-running the resume in a loop. `--device-code` 또는 `--resume-last`와 함께 써요	—
`--watch`	boolean	Poll the bootstrap status endpoint until done/failed	—
`--watch-interval`	string	Poll interval such as 2s or 1m. Minimum 1s; defaults to 2s	—
`--watch-timeout`	string	Maximum watch time such as 30m, 60s. Defaults to 30m	—

`axhub apps bootstrap-status`

bootstrap 진행 상태를 확인해요.

플래그	타입	설명	기본값
`<bootstrap>`	string (인자)	Bootstrap id returned by `axhub apps bootstrap --execute`	—
`--tenant`	string	Tenant slug or id. Defaults to the active tenant when omitted	—
`--watch`	boolean	Poll until done/failed	—
`--watch-interval`	string	Poll interval such as 2s or 1m. Minimum 1s; defaults to 2s	—
`--watch-timeout`	string	Maximum watch time such as 30m, 60s. Defaults to 30m	—

`axhub apps check-availability`

slug · subdomain 사용 가능 여부를 확인해요.

플래그	타입	설명	기본값
`--slug`	string	App slug to preflight	—
`--subdomain`	string	App subdomain label to preflight	—
`--tenant`	string	Tenant slug or id. Defaults to the active tenant when omitted	—

`axhub apps co-owners`

앱 공동 소유자(co-owner)를 관리해요.

`axhub apps co-owners list`

대표 소유자와 공동 소유자 전체를 봐요 (읽기 전용).

플래그	타입	설명	기본값
`--app`	string	App id or slug	—

`axhub apps co-owners add`

사용자에게 공동 소유권을 부여해요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--user`	string	Target user id	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—

`axhub apps co-owners remove`

사용자의 공동 소유권을 회수해요 — 소유자 전용 접근이 즉시 끊겨요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--user`	string	Target user id	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—

`axhub apps create`

새 앱을 만들어요.

플래그	타입	설명	기본값
`--auth-mode`	string	App auth mode: cookie, bearer, `api_key`, or anonymous	—
`--category`	string	App category slug or ID.	—
`--data-scopes`	string	Comma-separated data scopes	—
`--deploy-method`	string	Deploy method on creation: `docker` (default), `compose`, or `static`. Immutable after create — backend rejects subsequent updates with `invalid_state_transition` / `immutable_field`	—
`--description`	string	App description (≤20000 chars). Symmetric with `apps update --description`	—
`--from-file`	string	Path to a local input file.	—
`--icon-dark-url`	string	Dark-mode icon URL	—
`--icon-url`	string	Light-mode icon URL (typically from `axhub apps sign-icon-upload`)	—
`--interactive`	boolean	Use an interactive prompt when terminal input is available.	—
`--name`	string	Resource display name.	—
`--resource-tier`	string	Pod resource tier on creation: `XS` / `S` / `M` / `L` / `XL`. Sent to the API as `resource_preset`. Tenant max (`tenants.max_resource_tier`, default `L`) is enforced backend-side	—
`--slug`	string	Stable slug or identifier for the resource.	—
`--subdomain`	string	Subdomain on creation. Persisted as `apps.subdomain` (spec 285 fix)	—
`--tenant`	string	Tenant slug or ID used to scope the command.	—

`axhub apps delete`

앱을 삭제해요.

플래그	타입	설명	기본값
`<app>`	string (인자)	App slug or ID to operate on.	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—

`axhub apps detect`

기존 GitHub 저장소의 빌드 설정을 감지해요 (읽기 전용, 마이그레이션용).

플래그	타입	설명	기본값
`--owner`	string	Repository owner. Use together with --repo-name	—
`--path`	string	Sub-path within the repository (monorepo app root)	—
`--ref`	string	Git ref (branch, tag, or commit SHA). Defaults to the repo default branch	—
`--repo`	string	GitHub repository as `owner/repo`. Alternative to --owner + --repo-name	—
`--repo-name`	string	Repository name. Use together with --owner	—

`axhub apps discover`

공개된 앱을 둘러봐요.

플래그	타입	설명	기본값
`--category`	string	App category slug or ID.	—
`--created-within-days`	string	Filter apps created within N days (1..=3650)	—
`--limit`	integer	Pagination control for list output.	—
`--page`	integer	Page number (1-based)	—
`--per-page`	integer	Page size forwarded to the backend as the dedicated `per_page=N` query key (distinct from `--limit`, which is forwarded verbatim as `limit=N`). If both flags are passed, `--limit` wins. Integrations that capture the outbound query string must read `per_page` and `limit` independently	—
`--q`	string	Search query string.	—
`--sort`	string	Sort order for list output.	—
`--tenant`	string	Tenant slug or id scope (tenant-scoped discover)	—

`axhub apps domains`

앱의 커스텀 도메인을 관리해요.

`axhub apps domains list`

앱의 커스텀 도메인 목록을 봐요 (읽기 전용).

플래그	타입	설명	기본값
`--app`	string	App id or slug	—

`axhub apps domains add`

커스텀 도메인을 등록하고 게시할 DNS 레코드를 받아요. DNS 레코드를 게시하고 domains verify가 성공할 때까지 도메인은 pending 상태예요.

플래그	타입	설명	기본값
`<host>`	string (인자)	Hostname to attach, e.g. app.example.com	—
`--app`	string	App id or slug	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—

`axhub apps domains remove`

커스텀 도메인을 분리해요 — 인증서가 삭제되고 트래픽이 즉시 끊겨요. 멱등이 아니라 두 번째 실행은 종료 코드 5로 끝나요.

플래그	타입	설명	기본값
`<domain_id>`	string (인자)	Custom domain id (from `domains list`), not the hostname	—
`--app`	string	App id or slug	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—

`axhub apps domains verify`

DNS를 재확인해서 도메인을 active 상태로 진행시켜요.

플래그	타입	설명	기본값
`<domain_id>`	string (인자)	Custom domain id (from `domains list`), not the hostname	—
`--app`	string	App id or slug	—
`--wait`	boolean	Poll until the domain becomes active or disconnected; bounded by the global `--timeout` (exit 10 on overrun)	—

`axhub apps fork`

앱을 복제해요.

플래그	타입	설명	기본값
`<source>`	string (인자)	Source app slug/id	—
`--dry-run`	boolean	Dry-run preview is the default	`true`
`--execute`	boolean	Execute the fork bootstrap saga	—
`--name`	string	New app display name. Defaults to --slug	—
`--repo-public`	boolean	Create a public fork repo when the bootstrap backend creates GitHub resources	—
`--slug`	string	New app slug	—
`--subdomain`	string	New app subdomain label	—
`--template`	string	Override source template id when the source app does not expose one	—
`--tenant`	string	Destination tenant slug/id. Defaults to the active tenant	—

`axhub apps get`

앱 상세 정보를 조회해요.

플래그	타입	설명	기본값
`<app>`	string (인자)	App slug or ID to operate on.	—

`axhub apps git`

앱의 GitHub 연결을 관리해요.

`axhub apps git connect`

앱에 GitHub 저장소를 연결해요.

플래그	타입	설명	기본값
`--app`	string	App id or slug. Preferred for agent scripts	—
`--branch`	string	Branch to connect	`main`
`--device-code`	string	Resume an already-issued GitHub OAuth device code (env: `AXHUB_GITHUB_DEVICE_CODE`)	—
`--direct`	boolean	Use the direct backend connection endpoint with repo-owner installation resolution	—
`--dry-run`	boolean	Dry-run preview is the default. Pass --execute to mutate	`true`
`--execute`	boolean	Execute the backend git-connection mutation	—
`--installation-id`	integer	Optional explicit GitHub App installation id; must belong to the repo owner	—
`--no-browser`	boolean	Alias for direct backend connection mode; no browser/device flow is launched	—
`--repo`	string	Repository in owner/repo form	—
`--resume-last`	boolean	Resume the latest locally cached `GitHub` Device Flow for this profile	—
`--wait-approval`	string	Keep waiting for the user's GitHub approval inside this one command, up to the given duration (6s–10m; e.g. 90s). Without it the resume polls once and exits. Use it instead of re-running the resume in a loop. `--device-code` 또는 `--resume-last`와 함께 써요	—

`axhub apps git disconnect`

GitHub 저장소 연결을 끊어요.

플래그	타입	설명	기본값
`--app`	string	App id or slug. Preferred for agent scripts	—
`--dry-run`	boolean	Dry-run preview is the default. Pass --execute to mutate	`true`
`--execute`	boolean	Execute the backend disconnect mutation	—

`axhub apps git status`

GitHub 연결 상태를 확인해요.

플래그	타입	설명	기본값
`--app`	string	App id or slug. Preferred for agent scripts	—

`axhub apps git update`

GitHub 연결 설정(브랜치)을 수정해요.

플래그	타입	설명	기본값
`--app`	string	App id or slug. Preferred for agent scripts	—
`--branch`	string	New branch name	—
`--dry-run`	boolean	Dry-run preview is the default. Pass --execute to mutate	`true`
`--execute`	boolean	Execute the backend update mutation	—

배포 검사 파이프라인이 이 앱의 소스 코드를 외부 LLM 리뷰어에 보내는 것에 대한 동의를 확인 · 설정해요. 동의를 철회해도 이미 전송된 코드는 회수되지 않고, LLM 의견은 참고용일 뿐 차단 판정은 결정적 스캐너(axhub deploy scan)가 내려요. axhub apps inspection-consent --app <앱>은 get의 축약형이에요.

앱의 현재 코드 검사 동의 상태를 봐요 (읽기 전용).

플래그	타입	설명	기본값
`--app`	string	App id or slug	—

동의를 부여하거나 철회해요. --granted와 --revoked 중 하나는 필수예요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--granted`	boolean	Allow the deploy inspection pipeline to send this app's source code to an LLM reviewer	—
`--revoked`	boolean	Withdraw consent; future inspections stop sending source code	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—

`axhub apps list`

앱 목록을 봐요.

플래그	타입	설명	기본값
`--all`	boolean	Fetch all pages the backend returns	—
`--category-id`	string	Category UUID filter	—
`--operating-status`	string	Operating rollup filter: live \| dev \| archived	—
`--operating-status-in`	string	Comma-separated operating rollup filter (OR)	—
`--page`	integer	Page number to request	—
`--page-size`	integer	Number of apps per page	—
`--per-page`	integer	Alias for --page-size	—
`--q`	string	Search query forwarded as q	—
`--review-status`	string	Single review status (backend authority — additional values may exist)	—
`--review-status-in`	string	Comma-separated review status filter	—
`--sort`	string	Sort key (backend authority — additional values may exist)	—
`--status`	string	App deployment status filter: draft \| deployed \| archived (spec 324)	—
`--tenant`	string	Tenant slug or id scope	—
`--visibility`	string	Visibility filter: `private` / `invite_only` / `public` / `internet`	—

`axhub apps members`

앱 멤버를 봐요.

플래그	타입	설명	기본값
`<app>`	string (인자)	App slug or ID to operate on.	—
`--page`	integer	Page number (1-based)	—
`--per-page`	integer	Page size (default 50, max 200)	—

`axhub apps mine`

내가 접근 가능한 앱을 봐요.

플래그	타입	설명	기본값
`--page`	integer	Page number to forward to the backend (current backend may return the full list)	—
`--per-page`	integer	Page size to forward to the backend (current backend may return the full list)	—

`axhub apps owned`

내가 소유한 앱을 봐요.

(옵션 없음)

`axhub apps ownership`

앱 대표 소유권을 관리해요.

`axhub apps ownership transfer`

대표 소유자 역할을 다른 사용자에게 넘겨요. 되돌릴 수 없어요 — 실행하면 본인은 공동 소유자로 강등되고, 새 소유자만 다시 되돌려줄 수 있어요. 실행은 --execute에 더해 전역 --yes까지 요구해요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--to`	string	User id that becomes the new representative owner	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Commit the transfer. Must be combined with the global `--yes`	—

`axhub apps purge`

삭제된 앱을 완전히 제거해요.

플래그	타입	설명	기본값
`<app>`	string (인자)	App slug or ID to operate on.	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—

`axhub apps raw-db`

앱 전용 raw Postgres 데이터베이스를 관리해요.

`axhub apps raw-db disable`

raw 데이터베이스를 꺼요 (되돌릴 수 없어요).

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—

`axhub apps raw-db enable`

raw 데이터베이스를 켜요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—

`axhub apps reactivate`

보관된 앱을 복구해요.

플래그	타입	설명	기본값
`<app>`	string (인자)	App slug or ID to operate on.	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—

`axhub apps received`

공유받은 앱을 봐요 (소유 앱 제외).

(옵션 없음)

`axhub apps resource-presets`

백엔드 리소스 사양 프리셋 목록을 봐요.

(옵션 없음)

`axhub apps resume`

일시정지한 앱을 재개해요 — 백엔드가 마지막 성공 배포를 자동 재배포해요.

플래그	타입	설명	기본값
`<app>`	string (인자)	App slug or ID to operate on.	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—

`axhub apps search`

앱을 검색해요.

플래그	타입	설명	기본값
`<query>`	string (인자)	Search query string.	—
`--all`	boolean	—	—
`--category`	string	App category slug or ID.	—
`--cursor`	string	Backend cursor for the next search page	—
`--limit`	integer	Backend page-size limit; takes precedence over --per-page	—
`--page`	integer	Pagination control for list output.	—
`--per-page`	integer	Pagination control for list output.	—
`--sort`	string	Sort order for list output.	—
`--status`	string	App deployment status filter: draft \| deployed \| archived	—
`--status-in`	string	Comma-separated status filter	—
`--visibility`	string	—	—

`axhub apps sign-icon-upload`

앱 아이콘 업로드용 서명 URL을 발급해요.

플래그	타입	설명	기본값
`--app`	string	App slug or id (required unless `--pre-create` is set)	—
`--content-type`	string	Explicit content type for pre-create mode (overrides file extension detection since no file is read)	—
`--dry-run`	boolean	Preview only — request the signed URL but skip the PUT upload (default)	`true`
`--execute`	boolean	Commit the upload; mutually exclusive with --dry-run	—
`--file`	string	Path to the icon file to upload (PNG/JPEG/WEBP/GIF, ≤ 2MB). Ignored in `--pre-create` mode (no upload happens)	—
`--pre-create`	boolean	Pre-create mode: request a presigned PUT URL for the tenant-level `POST /api/v1/tenants/{tID}/apps/icon/upload-url` endpoint so the icon can be uploaded before the app exists. Requires `--tenant` + `--slug` + `--content-type`. Skips the local file PUT; the caller drives the upload to the returned `put_url` with their own client	`false`
`--slug`	string	App slug for pre-create mode (the slug the app will have)	—
`--tenant`	string	Tenant slug or id for pre-create mode	—
`--variant`	string	Icon variant: `light` (default) or `dark`	`light`

`axhub apps static`

앱의 정적 호스팅(릴리즈 · 사이트)을 관리해요.

`axhub apps static auth`

보호된 정적 사이트 인증을 다뤄요.

`axhub apps static auth start`

대상 URL로 정적 사이트 인증을 시작해요 (OAuth 로그인 필요).

플래그	타입	설명	기본값
`--target`	string	Static-site URL to authenticate. OAuth login required.	—

`axhub apps static deploy`

로컬 디렉터리를 새 정적 릴리즈로 배포해요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—
`--from-dir`	string	Local directory whose files become the static release	—
`--release-version`	string	Optional release version label. The clap field is `release_version` (and flag `--release-version`) to avoid colliding with the global `--version` flag's arg id; it is sent to the backend as `version`	—
`--tenant`	string	Tenant id or slug (defaults to the active tenant)	—

`axhub apps static releases`

정적 릴리즈를 관리해요.

`axhub apps static releases activate`

정적 릴리즈를 활성화해요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—
`--release-id`	string	Release id	—
`--tenant`	string	Tenant id or slug (defaults to the active tenant)	—

`axhub apps static releases create`

새 정적 릴리즈를 만들어요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--body-json`	string	Inline JSON object request body	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—
`--from-file`	string	Path to a JSON object request body	—
`--tenant`	string	Tenant id or slug (defaults to the active tenant)	—

`axhub apps static releases finalize`

정적 릴리즈를 확정해요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—
`--release-id`	string	Release id	—
`--tenant`	string	Tenant id or slug (defaults to the active tenant)	—

`axhub apps static releases list`

정적 릴리즈 목록을 봐요 (읽기 전용).

플래그	타입	설명	기본값
`--app`	string	App slug or ID to operate on.	—
`--tenant`	string	Tenant slug or ID used to scope the command.	—

`axhub apps static releases promote-approve`

대기 중인 승격 요청을 승인해요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—
`--release-id`	string	Release id	—
`--tenant`	string	Tenant id or slug (defaults to the active tenant)	—

`axhub apps static releases promote-reject`

대기 중인 승격 요청을 반려해요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—
`--release-id`	string	Release id	—
`--tenant`	string	Tenant id or slug (defaults to the active tenant)	—

`axhub apps static releases promote-request`

스테이징 릴리즈의 프로덕션 승격 심사를 요청해요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—
`--release-id`	string	Release id	—
`--tenant`	string	Tenant id or slug (defaults to the active tenant)	—

`axhub apps static releases revoke`

정적 릴리즈를 철회해요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—
`--release-id`	string	Release id	—
`--tenant`	string	Tenant id or slug (defaults to the active tenant)	—

`axhub apps static releases rollback`

이전 정적 릴리즈로 되돌려요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—
`--release-id`	string	Release id	—
`--tenant`	string	Tenant id or slug (defaults to the active tenant)	—

`axhub apps static releases stage`

스테이징 호스트가 가리킬 릴리즈를 지정해요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—
`--release-id`	string	Release id	—
`--tenant`	string	Tenant id or slug (defaults to the active tenant)	—

`axhub apps static site`

정적 사이트 설정을 확인 · 변경해요.

`axhub apps static site get`

현재 정적 사이트 설정을 봐요 (읽기 전용).

플래그	타입	설명	기본값
`--app`	string	App slug or ID to operate on.	—
`--tenant`	string	Tenant slug or ID used to scope the command.	—

`axhub apps static site set`

정적 사이트 설정을 교체해요.

정적 전용 공개 설정은 폐기됐어요. 정적 페이지 접근은 이제 앱 공개 범위가 단독으로 결정해요 — 아래 --visibility 값은 서버가 무시해요. 공개 범위 변경은 axhub apps update --visibility(좁히기) · axhub publish(넓히기)로 하세요. Service Worker도 설정과 무관하게 항상 차단돼요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--body-json`	string	Inline JSON object request body	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—
`--from-file`	string	Path to a JSON object request body	—
`--service-worker-allowed`	boolean	폐기 — 무시돼요. Service Worker는 항상 차단돼요	—
`--service-worker-disallowed`	boolean	폐기 — 무시돼요. Service Worker는 항상 차단돼요	—
`--tenant`	string	Tenant id or slug (defaults to the active tenant)	—
`--visibility`	string	폐기 — 무시돼요. 접근은 앱 공개 범위가 결정해요	—

`axhub apps static site staging`

정적 사이트 스테이징 호스트를 켜고 꺼요.

`axhub apps static site staging disable`

스테이징 호스트를 꺼요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—
`--tenant`	string	Tenant id or slug (defaults to the active tenant)	—

`axhub apps static site staging enable`

릴리즈 검토용 스테이징 호스트를 켜요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—
`--tenant`	string	Tenant id or slug (defaults to the active tenant)	—

`axhub apps static site unpublish`

정적 사이트 게시(콘텐츠 제공)를 중단해요. 앱 공개 범위는 바뀌지 않아요 — 다시 게시하면 이전 범위 그대로 열려요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—
`--tenant`	string	Tenant id or slug (defaults to the active tenant)	—

`axhub apps storage`

앱 파일 스토리지(선언형 오브젝트 스토리지)를 관리해요. axhub.yaml의 storage.enabled: true로도 켤 수 있어요 — 스토리지 연결하기를 보세요.

`axhub apps storage status`

스토리지 프로비저닝 상태와 접근 정보를 봐요 (읽기 전용).

플래그	타입	설명	기본값
`--app`	string	App id or slug	—

`axhub apps storage enable`

앱 스토리지를 프로비저닝해요 (멱등).

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—

`axhub apps storage ls`

저장된 오브젝트를 커서 페이지 단위로 나열해요.

플래그	타입	설명	기본값
`--app`	string	App id or slug	—
`--prefix`	string	Only list keys starting with this prefix	—
`--delimiter`	string	Group keys past this separator into prefixes (folder view), e.g. /	—
`--limit`	integer	Backend page size for this request	—
`--cursor`	string	Cursor from a previous page's next_cursor	—

`axhub apps storage get-url`

오브젝트 키 하나에 대한 presigned https 다운로드 URL을 발급해요.

플래그	타입	설명	기본값
`<key>`	string (인자)	Object key	—
`--app`	string	App id or slug	—

`axhub apps storage rm`

오브젝트 하나를 삭제해요 — 백엔드에 CLI 측 undo가 없어요.

플래그	타입	설명	기본값
`<key>`	string (인자)	Object key	—
`--app`	string	App id or slug	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—

`axhub apps suspend`

앱 실행을 일시정지해요.

플래그	타입	설명	기본값
`<app>`	string (인자)	App slug or ID to operate on.	—
`--dry-run`	boolean	Preview the operation without applying state changes.	`true`
`--execute`	boolean	Apply the state-changing operation instead of previewing it.	—

플래그	타입	설명	기본값
`<app>`	string (인자)	App slug or ID to operate on.	—
`--auth-mode`	string	New auth mode: cookie, bearer, `api_key`, or anonymous	—
`--category-id`	string	New category UUID	—
`--clear-category`	boolean	Clear the category (wins over `--category-id`)	—
`--clear-cost-center`	boolean	Clear the cost attribution label	—
`--clear-subdomain`	boolean	Clear the subdomain (mutually exclusive with `--subdomain`)	—
`--cost-center`	string	New cost attribution label	—
`--data-scopes`	string	New comma-separated data scopes	—
`--description`	string	New description (≤20000 chars). Pass an empty string to clear	—
`--icon-dark-url`	string	New dark-mode icon URL	—
`--icon-url`	string	New light-mode icon URL (typically from `axhub apps sign-icon-upload`)	—
`--name`	string	New display name (1~100 chars)	—
`--resource-tier`	string	New Pod resource tier: `XS` / `S` / `M` / `L` / `XL`. Sent to the API as `resource_preset`. Tenant max enforced backend-side	—
`--subdomain`	string	New subdomain	—
`--summary`	string	New one-line app summary (≤60 chars). Pass an empty string to clear	—
`--visibility`	string	New visibility: `private` / `invite_only` / `public` / `internet`. 현재 값보다 좁게만 지정할 수 있어요 — 넓히려면 `axhub publish`로 공개 신청 (위반 시 409 `visibility_widen_not_allowed`)	—

`axhub apps workspace`

워크스페이스 앱을 봐요.

(옵션 없음)

`axhub init`

현재 디렉터리에 새 axhub.yaml을 스캐폴드해요.

플래그	타입	설명	기본값
`<args>`	string (인자)	—	—

플래그	타입	설명	기본값
`--branch`	string	—	—
`--installation-id`	integer	—	—
`--repo`	string	—	—
`--state`	string	—	—

`axhub github installations`

GitHub App 설치에서 접근 가능한 저장소를 봐요.

`axhub github installations repos`

설치에서 접근 가능한 저장소 목록을 봐요.

플래그	타입	설명	기본값
`--installation-id`	integer	GitHub App installation id	—
`--page`	integer	Page number to request	—
`--per-page`	integer	Repositories per page	—

`axhub github link`

브라우저 없는 디바이스 링크 플로우로 GitHub 계정을 연동해요.

플래그	타입	설명	기본값
`--tenant`	string	Tenant id or slug (defaults to the active tenant)	—

`axhub open`

배포된 앱을 브라우저에서 열어요.

플래그	타입	설명	기본값
`<args>`	string (인자)	—	—
`--logs`	boolean	—	—
`--metrics`	boolean	—	—

`axhub categories`

앱 카테고리를 조회해요.

`axhub categories get`

카테고리 상세를 조회해요.

플래그	타입	설명	기본값
`<id>`	string (인자)	Resource identifier.	—
`--tenant`	string	Tenant slug or ID used to scope the command.	—

카테고리 목록을 봐요.

플래그	타입	설명	기본값
`--all`	boolean	—	—
`--page`	integer	Pagination control for list output.	—
`--per-page`	integer	Pagination control for list output.	—
`--tenant`	string	Tenant slug or ID used to scope the command.	—

`axhub review`

앱 공개 심사 요청을 조회해요.

`axhub review get`

심사 상세를 조회해요.

플래그	타입	설명	기본값
`<request_id>`	string (인자)	publication request id	—

`axhub review history`

심사 이력을 봐요.

플래그	타입	설명	기본값
`--app`	string	app slug or id for per-app history	—
`--page`	integer	page number for per-app history (default 1)	—
`--page-size`	integer	items per page (default 20)	—
`--tenant`	string	tenant id for tenant-wide settled history; overrides global --tenant	—

`axhub publish`

앱을 공개 심사에 제출해요.

플래그	타입	설명	기본값
`--app`	string	App id or slug (defaults to axhub.yaml name/app.slug)	—
`--deployment-id`	string	Deployment id to publish (staging apps)	—
`--dry-run`	boolean	Preview the publication request without submitting (default)	`true`
`--execute`	boolean	Submit the publication request	—
`--note`	string	Submission note for the reviewer	—
`--visibility`	string	Requested visibility for a normal app: `invite_only` / `public` / `internet`	—