AppGallery Connect, mapped for the terminal

Move every release through one red line.

A Go command center for discovering, dry-running, and invoking AppGallery Connect APIs—with stable JSON for people, CI, and coding agents.

21 API families286 registered interfaces3 output formats
agc / productionreference mode
agcTerminalJSONAgentScript
One command surface. Your workflow.
AUTHPS256 / OAuth
PROFILEproject-bound
PACKAGEupload + status
RELEASEinvoke by choice

$ agc auth check --pretty

{
  "data": {
    "name": "production",
    "mode": "service-account",
    "active": true
  },
  "affordances": {
    "next": "agc publishing endpoints"
  }
}

project profile resolved · dry-run on

Dry-run firstNothing is sent until you opt in.
Agent-readableJSON envelopes include next actions.
One surfaceCLI, local REST, and web share a registry.

Install agc CLI

Use the package manager for your system.

Use NPM for one unattended command across Windows, macOS, and Linux CI. Native Homebrew and Scoop packages remain available for developer workstations.

Windows · macOS · Linux CI
$ npm install --global @createitv/agc-cli && agc version
macOS Homebrew command
$ brew tap createitv/tap && brew install agc-cli && agc version
Windows Scoop command
PS> if (!(Get-Command scoop -ErrorAction SilentlyContinue)) { Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force; irm get.scoop.sh | iex }; scoop bucket add createitv https://github.com/Createitv/scoop-bucket; scoop install agc-cli; agc version
NPM: Node.js 18+ No postinstall download Five checksum-verified platform binaries

Agent Skills

Give your coding agent a map of AppGallery Connect.

Six portable Skills follow the task-oriented asc-cli pattern. Install all of them, choose one workflow, inspect the source, or contribute improvements through GitHub.

Contribute a Skill
Install all six for Codex$ agc skills install --agent codex --global
agc-cli-usage

General command discovery, dry-run review, authorized execution, and remote verification.

agc skills install --name agc-cli-usage --agent codex --global
agc-auth

Credential profiles, whoami, OAuth team lookup, and authorization diagnosis.

agc skills install --name agc-auth --agent codex --global
agc-publishing

Metadata, packages, review submission, staged rollout, and release-state verification.

agc skills install --name agc-publishing --agent codex --global
agc-testing

Test versions, groups, testers, invitation links, feedback, and promotion.

agc skills install --name agc-testing --agent codex --global
agc-reports

Distribution, install, revenue, retention, and HarmonyOS service report exports.

agc skills install --name agc-reports --agent codex --global
agc-cicd

Pinned cross-platform installation, protected credentials, dry-run gates, and CI verification.

agc skills install --name agc-cicd --agent codex --global

The release rail

Context flows forward. Secrets do not.

Each stage owns one job. Credentials remain local, project context remains portable, and destructive API calls require an explicit switch.

01

AUTH

PS256 / OAuth

02

PROFILE

project-bound

03

PACKAGE

upload + status

04

RELEASE

invoke by choice

Automatic profile binding

Choose once per project. Override only when you mean it.

Bind production in .agc/project.json. Commands resolve the profile in a predictable order, while --profile staging remains available for one-off work.

  1. 1CLI override--profile staging
  2. 2Project default.agc/project.json
  3. 3Active account~/.agc/credentials.json
.agc/project.json project safe
{
  "appId": "123456789",
  "projectId": "987654321",
  "packageName": "com.example.app",
  "profile": "production"
}
No client keys or private keys are stored here.

Interface registry

Discover the API before writing the request.

Every entry carries its method, path, parameter locations, CLI command, REST route, and dry-run path.

Selected family / hosting

Cloud Hosting

registered

Website sites, environments, signed ZIP uploads, archive and release.

DISCOVERagc hosting endpoints --output table
STATUSagc hosting status --pretty
LOCAL REST/api/v1/hosting
16 typed interface entries

All endpoints 16

Expand an endpoint for registered parameters and commands. Consult its reference for full schemas, responses, and permissions.

POST创建版本create-version/api/cloudhosting/web/v1/version/create

此接口用于创建云托管站点版本,已归档版本可作为新版本的基线版本。

Developer-to-Huawei API

Registered parameters
ParameterLocationRequiredTypeDescription
AuthorizationheaderNostring认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。
productIdheaderYesstring项目ID,获取方法参考查询开发者账号ID及项目ID。
requestidheaderYesstring自定义的请求字符串,必须唯一标识此请求。
client_idheaderNostring客户端ID,获取方法参考创建API客户端。
serviceheaderYesstringAPI业务标识。固定值:hosting。
siteIdbodyYesstring云托管版本所在的站点ID。 可根据站点名称查询站点ID,获取方法参考查询站点信息。
baseVersionbodyNostring基线版本号,基于该版本创建新的版本。 仅支持版本状态为“FINALIZED”的版本作为基线版本。

Request body: siteId,baseVersion

Inspect definition

agc hosting create-version --pretty

Local REST definition

/api/v1/hosting/endpoints/create-version

Dry run (supply required parameters first)

agc hosting create-version --invoke --dry-run=true --body body.json
Read endpoint reference ↗
POST修改版本文件列表modify-files/api/cloudhosting/web/v1/version/modifyFilelist

此接口用于对基线版本需要删除的文件做版本修改,标记需要删除文件的绝对路径,在归档版本时处理文件。

Developer-to-Huawei API

Registered parameters
ParameterLocationRequiredTypeDescription
AuthorizationheaderNostring认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。
productIdheaderYesstring项目ID,获取方法参考查询开发者账号ID及项目ID。
requestidheaderYesstring自定义的请求字符串,必须唯一标识此请求。
client_idheaderNostring客户端ID,获取方法参考创建API客户端。
serviceheaderYesstringAPI业务标识。固定值:hosting。
siteIdbodyYesstring云托管站点版本所在的站点ID。 可根据站点名称查询站点ID,获取方法参考查询站点信息。
versionbodyYesstring当前版本的版本号(仅支持版本状态为“CREATED”的版本)。
deleteFilesbodyYesarray需要删除的文件列表(文件的绝对路径),一次最多删除1000个。

Request body: siteId,version,deleteFiles

Inspect definition

agc hosting modify-files --pretty

Local REST definition

/api/v1/hosting/endpoints/modify-files

Dry run (supply required parameters first)

agc hosting modify-files --invoke --dry-run=true --body body.json
Read endpoint reference ↗
POST获取版本压缩包上传地址upload-url/api/cloudhosting/web/v1/version/populateFiles

此接口用于获取增量版本文件压缩包或全量版本文件压缩包的上传地址等信息,并完成增量版本包上传。您可以多次获取上传地址,以最后一次获取为最终增量版本。

Developer-to-Huawei API

Registered parameters
ParameterLocationRequiredTypeDescription
AuthorizationheaderNostring认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。
productIdheaderYesstring项目ID,获取方法参考查询开发者账号ID及项目ID。
requestidheaderYesstring自定义的请求字符串,必须唯一标识此请求。
client_idheaderNostring客户端ID,获取方法参考创建API客户端。
serviceheaderYesstringAPI业务标识。固定值:hosting。
siteIdbodyYesstring云托管版本所在的站点ID。 可根据站点名称查询站点ID,获取方法参考查询站点信息。
versionbodyYesstring当前版本的版本号(只支持“CREATED”状态版本)
materialInfosbodyYesarrayzip增量包参数信息。

Request body: siteId,version,materialInfos

Inspect definition

agc hosting upload-url --pretty

Local REST definition

/api/v1/hosting/endpoints/upload-url

Dry run (supply required parameters first)

agc hosting upload-url --invoke --dry-run=true --body body.json
Read endpoint reference ↗
PUT上传版本压缩包upload-version{uploadUrl}

通过获取上传地址的响应请求地址、请求方法、请求头信息,上传版本压缩包至云托管。

Developer-to-Huawei API

Registered parameters
ParameterLocationRequiredTypeDescription
AuthorizationheaderYesstring校验信息,对应获取版本压缩包上传地址接口返回的headers参数中的Authorization。
x-amz-content-sha256headerYesstring文件对象内容的SHA256哈希值,对应获取版本压缩包上传地址接口返回的headers参数中的x-amz-content-sha256。
x-amz-client-request-idheaderYesstring文件上传的唯一标识,对应获取版本压缩包上传地址接口返回的headers参数中的x-amz-client-request-id。
x-amz-dateheaderYesstring文件上传地址生成的时间,对应获取版本压缩包上传地址接口返回的headers参数中的x-amz-date。
HostheaderYesstring上传服务器地址,对应获取版本压缩包上传地址接口返回的headers参数中的Host。
Content-TypeheaderYesstring对象内容的类型,对应获取版本压缩包上传地址接口返回的headers参数中的Content-Type。
uploadUrlpathYesstring—
filefileYesstring—

Request body: file

Inspect definition

agc hosting upload-version --pretty

Local REST definition

/api/v1/hosting/endpoints/upload-version

Dry run (supply required parameters first)

agc hosting upload-version --invoke --dry-run=true --body body.json
Read endpoint reference ↗
POST归档版本archive-version/api/cloudhosting/web/v1/version/merge

版本包上传完成后,此接口用于对新版本进行归档。如果上传的是增量版本包,云托管对基线版本和增量版本包进行合并,归档为完整的新版本文件包。归档版本是异步操作,从开始到完成,版本的状态从“MERGING”变为“FINALIZED”。

Developer-to-Huawei API

Registered parameters
ParameterLocationRequiredTypeDescription
AuthorizationheaderNostring认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。
productIdheaderYesstring项目ID,获取方法参考查询开发者账号ID及项目ID。
requestidheaderYesstring自定义的请求字符串,必须唯一标识此请求。
client_idheaderNostring客户端ID,获取方法参考创建API客户端。
serviceheaderYesstringAPI业务标识。固定值:hosting。
siteIdbodyYesstring云托管版本所在站点ID。 可根据站点名称查询站点ID,获取方法参考查询站点信息。
versionbodyYesstring当前版本的版本号(只支持“CREATED”状态)。

Request body: siteId,version

Inspect definition

agc hosting archive-version --pretty

Local REST definition

/api/v1/hosting/endpoints/archive-version

Dry run (supply required parameters first)

agc hosting archive-version --invoke --dry-run=true --body body.json
Read endpoint reference ↗
POST发布版本release-version/api/cloudhosting/web/v1/version/release

此接口用于发布新版本。

Developer-to-Huawei API

Registered parameters
ParameterLocationRequiredTypeDescription
AuthorizationheaderNostring认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。
productIdheaderYesstring项目ID,获取方法参考查询开发者账号ID及项目ID。
requestidheaderYesstring自定义的请求字符串,必须唯一标识此请求。
client_idheaderNostring客户端ID,获取方法参考创建API客户端。
serviceheaderYesstringAPI业务标识。固定值:hosting。
siteIdbodyYesstring云托管版本所在站点ID。 可根据站点名称查询站点ID,获取方法参考查询站点信息。
versionbodyYesstring当前版本的版本号。
environmentbodyYesinteger发布环境类型。 0:生产 1:沙箱

Request body: siteId,version,environment

Inspect definition

agc hosting release-version --pretty

Local REST definition

/api/v1/hosting/endpoints/release-version

Dry run (supply required parameters first)

agc hosting release-version --invoke --dry-run=true --body body.json
Read endpoint reference ↗
POST查询版本列表list-versions/api/cloudhosting/web/v1/version/query

此接口用于查询云托管站点下的版本列表。

Developer-to-Huawei API

Registered parameters
ParameterLocationRequiredTypeDescription
AuthorizationheaderNostring认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。
productIdheaderYesstring项目ID,获取方法参考查询开发者账号ID及项目ID。
requestidheaderYesstring自定义的请求字符串,必须唯一标识此请求。
client_idheaderNostring客户端ID,获取方法参考创建API客户端。
serviceheaderYesstringAPI业务标识。固定值:hosting。
siteIdbodyNostring云托管版本所在站点ID。
tenantIdbodyNostring租户ID,与项目ID一致。
versionbodyNostring版本ID。
versionStatusbodyNostring版本状态,参考版本状态码。

Request body: siteId,tenantId,version,versionStatus

Inspect definition

agc hosting list-versions --pretty

Local REST definition

/api/v1/hosting/endpoints/list-versions

Dry run (supply required parameters first)

agc hosting list-versions --invoke --dry-run=true --body body.json
Read endpoint reference ↗
POST查询归档版本文件list-version-files/api/cloudhosting/web/v1/version/queryFiles

此接口用于查询已归档版本的归档文件信息,为创建和修改版本提供基线版本内容的查询。

Developer-to-Huawei API

Registered parameters
ParameterLocationRequiredTypeDescription
AuthorizationheaderNostring认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。
productIdheaderYesstring项目ID,获取方法参考查询开发者账号ID及项目ID。
requestidheaderYesstring自定义的请求字符串,必须唯一标识此请求。
client_idheaderNostring客户端ID,获取方法参考创建API客户端。
serviceheaderYesstringAPI业务标识。固定值:hosting。
siteIdbodyYesstring云托管版本所在站点ID。
versionbodyYesstring站点版本ID。
pageInfobodyYesobject分页模型。

Request body: siteId,version,pageInfo

Inspect definition

agc hosting list-version-files --pretty

Local REST definition

/api/v1/hosting/endpoints/list-version-files

Dry run (supply required parameters first)

agc hosting list-version-files --invoke --dry-run=true --body body.json
Read endpoint reference ↗
DELETE删除版本delete-version/api/cloudhosting/web/v1/version/{versionId}

此接口用于删除站点下非“上线”状态的版本。

Developer-to-Huawei API

Registered parameters
ParameterLocationRequiredTypeDescription
AuthorizationheaderNostring认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。
productIdheaderYesstring项目ID,获取方法参考查询开发者账号ID及项目ID。
requestidheaderYesstring自定义的请求字符串,必须唯一标识此请求。
client_idheaderNostring客户端ID,获取方法参考创建API客户端。
serviceheaderYesstringAPI业务标识。固定值:hosting。
versionIdpathYesstring站点版本ID。

Inspect definition

agc hosting delete-version --pretty

Local REST definition

/api/v1/hosting/endpoints/delete-version

Dry run (supply required parameters first)

agc hosting delete-version --invoke --dry-run=true
Read endpoint reference ↗
POST创建站点环境create-environment/api/cloudhosting/web/v1/site/environment/create

此接口用于创建站点环境。

Developer-to-Huawei API

Registered parameters
ParameterLocationRequiredTypeDescription
AuthorizationheaderNostring认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。
productIdheaderYesstring项目ID,获取方法参考查询开发者账号ID及项目ID。
requestidheaderYesstring自定义的请求字符串,必须唯一标识此请求。
client_idheaderNostring客户端ID,获取方法参考创建API客户端。
serviceheaderYesstringAPI业务标识。固定值:hosting。
siteIdbodyYesstring站点ID。
environmentIdbodyYesstring环境ID。

Request body: siteId,environmentId

Inspect definition

agc hosting create-environment --pretty

Local REST definition

/api/v1/hosting/endpoints/create-environment

Dry run (supply required parameters first)

agc hosting create-environment --invoke --dry-run=true --body body.json
Read endpoint reference ↗
POST查询站点环境list-environments/api/cloudhosting/web/v1/site/environment/query

此接口用于查询站点环境。

Developer-to-Huawei API

Registered parameters
ParameterLocationRequiredTypeDescription
AuthorizationheaderNostring认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。
productIdheaderYesstring项目ID,获取方法参考查询开发者账号ID及项目ID。
requestidheaderYesstring自定义的请求字符串,必须唯一标识此请求。
client_idheaderNostring客户端ID,获取方法参考创建API客户端。
serviceheaderYesstringAPI业务标识。固定值:hosting。
siteIdbodyYesstring站点ID。
environmentIdbodyNostring环境ID。

Request body: siteId,environmentId

Inspect definition

agc hosting list-environments --pretty

Local REST definition

/api/v1/hosting/endpoints/list-environments

Dry run (supply required parameters first)

agc hosting list-environments --invoke --dry-run=true --body body.json
Read endpoint reference ↗
POST删除站点环境delete-environment/api/cloudhosting/web/v1/site/environment/delete

此接口用于删除站点环境。

Developer-to-Huawei API

Registered parameters
ParameterLocationRequiredTypeDescription
AuthorizationheaderNostring认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。
productIdheaderYesstring项目ID,获取方法参考查询开发者账号ID及项目ID。
requestidheaderYesstring自定义的请求字符串,必须唯一标识此请求。
client_idheaderNostring客户端ID,获取方法参考创建API客户端。
serviceheaderYesstringAPI业务标识。固定值:hosting。
siteIdbodyYesstring站点ID。
environmentIdbodyYesstring环境ID。

Request body: siteId,environmentId

Inspect definition

agc hosting delete-environment --pretty

Local REST definition

/api/v1/hosting/endpoints/delete-environment

Dry run (supply required parameters first)

agc hosting delete-environment --invoke --dry-run=true --body body.json
Read endpoint reference ↗
POST创建站点create-site/api/cloudhosting/web/v1/site/create

此接口用于创建泛域名站点。

Developer-to-Huawei API

Registered parameters
ParameterLocationRequiredTypeDescription
AuthorizationheaderNostring认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。
productIdheaderYesstring项目ID,获取方法参考查询开发者账号ID及项目ID。
requestidheaderYesstring自定义的请求字符串,必须唯一标识此请求。
client_idheaderNostring客户端ID,获取方法参考创建API客户端。
serviceheaderYesstringAPI业务标识。固定值:hosting。
siteNamebodyYesstring站点名。
descriptionbodyNostring站点描述信息。

Request body: siteName,description

Inspect definition

agc hosting create-site --pretty

Local REST definition

/api/v1/hosting/endpoints/create-site

Dry run (supply required parameters first)

agc hosting create-site --invoke --dry-run=true --body body.json
Read endpoint reference ↗
POST查询站点list-sites/api/cloudhosting/web/v1/site/query

此接口用于通过站点部分信息查询站点其他信息,例如通过站点名称查询站点ID。

Developer-to-Huawei API

Registered parameters
ParameterLocationRequiredTypeDescription
AuthorizationheaderNostring认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。
productIdheaderYesstring项目ID,获取方法参考查询开发者账号ID及项目ID。
requestidheaderYesstring自定义的请求字符串,必须唯一标识此请求。
client_idheaderNostring客户端ID,获取方法参考创建API客户端。
serviceheaderYesstringAPI业务标识。固定值:hosting。
sitebodyYesobject站点信息。
pageInfobodyNoobject分页模型。

Request body: site,pageInfo

Inspect definition

agc hosting list-sites --pretty

Local REST definition

/api/v1/hosting/endpoints/list-sites

Dry run (supply required parameters first)

agc hosting list-sites --invoke --dry-run=true --body body.json
Read endpoint reference ↗
POST更新站点update-site/api/cloudhosting/web/v1/site/modify

此接口用于更新站点描述信息及控制是否开启简洁链接。

Developer-to-Huawei API

Registered parameters
ParameterLocationRequiredTypeDescription
AuthorizationheaderNostring认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。
productIdheaderYesstring项目ID,获取方法参考查询开发者账号ID及项目ID。
requestidheaderYesstring自定义的请求字符串,必须唯一标识此请求。
client_idheaderNostring客户端ID,获取方法参考创建API客户端。
serviceheaderYesstringAPI业务标识。固定值:hosting。
siteIdbodyYesstring站点信息。
descriptionbodyNostring描述信息内容,匹配中文、空格、下划线、中划线、点、英文字母及数字。
cleanSuffixbodyNointeger简洁链接: 0-关闭。 1-开启。

Request body: siteId,description,cleanSuffix

Inspect definition

agc hosting update-site --pretty

Local REST definition

/api/v1/hosting/endpoints/update-site

Dry run (supply required parameters first)

agc hosting update-site --invoke --dry-run=true --body body.json
Read endpoint reference ↗
DELETE删除站点delete-site/api/cloudhosting/web/v1/site/{siteId}

此接口用于删除站点。

Developer-to-Huawei API

Registered parameters
ParameterLocationRequiredTypeDescription
AuthorizationheaderNostring认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。
productIdheaderYesstring项目ID,获取方法参考查询开发者账号ID及项目ID。
requestidheaderYesstring自定义的请求字符串,必须唯一标识此请求。
client_idheaderNostring客户端ID,获取方法参考创建API客户端。
serviceheaderYesstringAPI业务标识。固定值:hosting。
siteIdpathYesstring站点信息。

Inspect definition

agc hosting delete-site --pretty

Local REST definition

/api/v1/hosting/endpoints/delete-site

Dry run (supply required parameters first)

agc hosting delete-site --invoke --dry-run=true
Read endpoint reference ↗

What is agc-cli, and who is it for?

agc-cli is an open-source Go command-line tool for Huawei AppGallery Connect, maintained by Createitv. Its installed command is agc. It organizes API discovery, credential profiles, request previews, and API invocation into reusable commands for HarmonyOS and Huawei app developers who manage app metadata, testers, products, and reports.

Project and guides: GitHub · Usage guide · Issues

Frequently asked questions

Is agc-cli an official Huawei tool?

No. agc-cli is an independent open-source project maintained by Createitv under the MIT license. It organizes endpoints using Huawei AppGallery Connect API references and is not an official Huawei product or support service.

How do I install agc-cli on macOS, Windows, or Linux?

With Node.js 18+, all three systems can run npm install --global @createitv/agc-cli. Homebrew remains available on macOS and Scoop on Windows. Run agc version to verify installation.

Is agc-cli free, and do I need an account?

agc-cli is free to use and modify under the MIT license. Calling Huawei APIs requires your own AppGallery Connect account, credentials, and permissions. Huawei service pricing and limits remain subject to Huawei terms. Browsing the endpoint reference or inspecting CLI definitions does not require login.

How do I query app information for the first time?

Save credentials with agc auth login --service-account-file ~/.agc/service-account.json --name production, then bind the project with agc init --app-id YOUR_APP_ID --default-profile production. Preview with agc publishing app-info-query --invoke --query appId=YOUR_APP_ID --query lang=en-US. Add --dry-run=false after checking the request. Supply a client_id header explicitly when required.

Are all 156 endpoints production-verified?

No. The registry contains 156 entries across 13 API families; this is registry coverage, not production verification of every endpoint. Registered parameters and command surfaces are shown here. Consult each endpoint reference for full request and response schemas, permissions, and business prerequisites.

Does the default dry run change my app?

No. Endpoint commands with --invoke preview the request without sending it by default. Real invocation requires --dry-run=false. Check the target app, credential profile, and parameters before executing.

Can I use agc-cli with scripts or AI agents?

Yes. JSON output supports script processing. agc capabilities and agc endpoints expose discovery; agc web-server provides local REST routes, and agc openapi exports the contract. Command templates support navigation but do not replace business-state checks or review decisions.

How do I install the agc-cli Skills for Codex or Claude?

Install agc-cli, then run agc skills list to browse the six task-oriented Skills. Run agc skills install --agent codex --global for all Skills, or add --name agc-publishing for only the publishing Skill. Individual SKILL.md files are also downloadable from the website.

Does a project profile fill all endpoint parameters automatically?

A project configuration can select its default credential profile, with --profile for explicit overrides. App IDs, languages, headers, and request bodies still need to be supplied according to each endpoint. Keep Service Account private keys and credential files out of Git.

Browse the complete API reference by family

Content updated:

Quick start

Three commands to a bound, inspectable workspace.

Use placeholders for your AppGallery Connect values. The second command is what makes the profile automatic for this project.

01

Save a credential profile

Service Account is the preferred route. Secrets stay in ~/.agc/credentials.json with restricted permissions.

$ agc auth login --service-account-file ~/.agc/service-account.json --name production
02

Bind it to the project

Save project metadata and choose a default credential profile. Supply endpoint parameters explicitly when invoking APIs.

$ agc init --app-id <app-id> --project-id <project-id> --package-name com.example.app --default-profile production
03

Inspect before invoking

Endpoint commands are dry-run first. Review the exact method and URL, then opt into the real request.

$ agc publishing app-info-query --invoke --query appId=<app-id> --dry-run=false

Local command center

The browser is a window into the same registry.

Start the local REST server when you want live capability data. Without it, this site stays useful as a complete reference surface.

agc web-server --addr :8421
GET/api/v1/capabilitiesfamilies + affordances
GET/api/v1/endpointsall interface entries
GET/api/v1/openapi.jsonmachine-readable contract
POST/api/v1/:family/endpoints/:id/invokedry-run by default