앱

앱 생성·조회·관리·심사·공개 관련 명령

`axhub apps`

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

`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	—
`--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 create`

새 앱을 만들어요.

플래그	타입	설명	기본값
`--auth-mode`	string	App auth mode: cookie, bearer, `api_key`, or anonymous	—
`--category`	string	—	—
`--data-scopes`	string	Comma-separated data scopes	—
`--deploy-method`	string	Deploy method on creation: `docker` (default) or `compose`. Immutable after create — backend rejects subsequent updates with `invalid_state_transition` / `immutable_field`	—
`--from-file`	string	—	—
`--interactive`	boolean	—	—
`--name`	string	—	—
`--resource-tier`	string	Pod resource tier on creation: `S` / `M` / `L` / `XL`. Tenant max (`tenants.max_resource_tier`, default `L`) is enforced backend-side	—
`--slug`	string	—	—
`--subdomain`	string	Subdomain on creation. Persisted as `apps.subdomain` (spec 285 fix)	—
`--tenant`	string	—	—

`axhub apps delete`

앱을 삭제해요.

플래그	타입	설명	기본값
`--app`	string	—	—
`--dry-run`	boolean	—	`true`
`--execute`	boolean	—	—

`axhub apps discover`

공개된 앱을 둘러봐요.

플래그	타입	설명	기본값
`--category`	string	—	—
`--created-within-days`	string	Filter apps created within N days (1..=3650)	—
`--limit`	integer	—	—
`--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	—	—
`--sort`	string	—	—
`--tenant`	string	Tenant slug or id scope (tenant-scoped discover)	—

`axhub apps fork`

앱을 복제해요.

플래그	타입	설명	기본값
`--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	—
`--source`	string	Source app slug/id	—
`--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	—	—

`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`)	—
`--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	Disambiguate when the GitHub App is installed on multiple accounts	—
`--repo`	string	Repository in owner/repo form	—
`--resume-last`	boolean	Resume the latest locally cached `GitHub` Device Flow for this profile	—

`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	—

`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	—

`axhub apps members`

앱 멤버를 봐요.

플래그	타입	설명	기본값
`--app`	string	—	—
`--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 purge`

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

플래그	타입	설명	기본값
`--app`	string	—	—
`--dry-run`	boolean	—	`true`
`--execute`	boolean	—	—

`axhub apps resume`

일시정지한 앱을 재개해요.

플래그	타입	설명	기본값
`--app`	string	—	—
`--dry-run`	boolean	—	`true`
`--execute`	boolean	—	—

`axhub apps search`

앱을 검색해요.

플래그	타입	설명	기본값
`--all`	boolean	—	—
`--category`	string	—	—
`--page`	integer	—	—
`--per-page`	integer	—	—
`--query`	string	—	—
`--sort`	string	—	—
`--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 suspend`

앱 실행을 일시정지해요.

플래그	타입	설명	기본값
`--app`	string	—	—
`--dry-run`	boolean	—	`true`
`--execute`	boolean	—	—

`axhub apps templates`

부트스트랩 템플릿을 봐요.

`axhub apps templates list`

템플릿 목록을 봐요.

(옵션 없음)

`axhub apps update`

앱 정보를 수정해요.

플래그	타입	설명	기본값
`--app`	string	—	—
`--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-subdomain`	boolean	Clear the subdomain (mutually exclusive with `--subdomain`)	—
`--data-scopes`	string	New comma-separated data scopes	—
`--description`	string	New description (≤1000 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~80 chars)	—
`--resource-tier`	string	New Pod resource tier: `S` / `M` / `L` / `XL`. Tenant max enforced backend-side	—
`--subdomain`	string	New subdomain	—
`--visibility`	string	New visibility: `private` / `invite_only` / `public`. Non-private requires `review_status=approved`	—

`axhub apps workspace`

소유·수신한 워크스페이스 앱을 봐요.

(옵션 없음)

`axhub init`

현재 디렉터리에서 새 앱 프로젝트를 시작해요.

플래그	타입	설명	기본값
`--args`	string	—	—

`axhub github`

GitHub 연동(설치·계정·저장소)을 관리해요.

`axhub github accounts`

연결된 GitHub 계정을 봐요.

`axhub github accounts list`

GitHub 계정 목록을 봐요.

(옵션 없음)

`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 open`

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

플래그	타입	설명	기본값
`--args`	string	—	—
`--logs`	boolean	—	—
`--metrics`	boolean	—	—

`axhub categories`

앱 카테고리를 관리해요.

`axhub categories create`

카테고리를 만들어요.

플래그	타입	설명	기본값
`--color`	string	—	—
`--description`	string	—	—
`--display-order`	integer	—	—
`--icon-url`	string	—	—
`--name`	string	—	—
`--slug`	string	—	—
`--tenant`	string	—	—

`axhub categories delete`

카테고리를 삭제해요.

플래그	타입	설명	기본값
`--dry-run`	boolean	—	`true`
`--execute`	boolean	—	—
`--id`	string	—	—
`--tenant`	string	—	—
`--yes` `-y`	boolean	—	—

`axhub categories get`

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

플래그	타입	설명	기본값
`--id`	string	—	—
`--tenant`	string	—	—

카테고리 목록을 봐요.

플래그	타입	설명	기본값
`--all`	boolean	—	—
`--page`	integer	—	—
`--per-page`	integer	—	—
`--tenant`	string	—	—

`axhub categories update`

카테고리를 수정해요.

플래그	타입	설명	기본값
`--color`	string	—	—
`--description`	string	—	—
`--display-order`	integer	—	—
`--dry-run`	boolean	—	`true`
`--execute`	boolean	—	—
`--icon-url`	string	—	—
`--id`	string	—	—
`--name`	string	—	—
`--slug`	string	—	—
`--tenant`	string	—	—

`axhub review`

앱 공개 심사를 관리해요.

`axhub review approve`

심사를 승인해요.

플래그	타입	설명	기본값
`--note`	string	approval note	—
`--request_id`	string	publication request id	—

`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 review list`

심사 목록을 봐요.

(옵션 없음)

`axhub review reject`

심사를 반려해요.

플래그	타입	설명	기본값
`--reason`	string	rejection reason	—
`--request_id`	string	publication request id	—

`axhub publish`

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

플래그	타입	설명	기본값
`--args`	string	—	—