# agc-cli: Open-source Huawei AppGallery Connect CLI for HarmonyOS 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. ## 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. ## Links - Website: https://agccli.app/en/ - Source: https://github.com/Createitv/agc-cli - API contracts: https://agccli.app/api-reference.json --- # agc-cli Agent Usage Guide Last updated: 2026-10-13 This guide helps Codex, Claude, and other coding agents use agc-cli without guessing commands or exposing credentials. agc-cli is an independent open-source project maintained by Createitv; it is not an official Huawei product. ## Recommended workflow 1. **Check identity and access** — `agc auth whoami --pretty` 2. **Discover capabilities** — `agc capabilities --pretty` 3. **List endpoints** — `agc endpoints --output table` 4. **Read endpoint docs** — `agc --docs --pretty` 5. **Preview a request** — `agc --invoke ...` 6. **Invoke explicitly** — `Add --dry-run=false only after checking the target, profile, and parameters` ## Safety boundaries - The default dry run builds a request without sending a remote change; real invocation requires an explicit `--dry-run=false`. - Never commit Service Account private keys, OAuth secrets, credential responses, or `~/.agc/credentials.json` to Git. - Registry coverage does not mean every endpoint is production-verified; follow the linked endpoint references for permissions, state, and complete models. - Uploads, review submissions, releases, and deletion operations require explicit user authorization and remote-state verification. ## Agent Skills - [agc-cli-usage](https://github.com/Createitv/agc-cli/tree/main/skills/agc-cli-usage) - [agc-auth](https://github.com/Createitv/agc-cli/tree/main/skills/agc-auth) - [agc-publishing](https://github.com/Createitv/agc-cli/tree/main/skills/agc-publishing) - [agc-testing](https://github.com/Createitv/agc-cli/tree/main/skills/agc-testing) - [agc-reports](https://github.com/Createitv/agc-cli/tree/main/skills/agc-reports) - [agc-cicd](https://github.com/Createitv/agc-cli/tree/main/skills/agc-cicd) Install all Skills: `agc skills install --agent codex --global` ## Machine-readable resources - [llms.txt](https://agccli.app/llms.txt) - [llms-full.txt](https://agccli.app/llms-full.txt) - [Skills index](https://agccli.app/skills.md) - [API contracts](https://agccli.app/api-reference.json) - [Open-source repository](https://github.com/Createitv/agc-cli) --- # agc-cli Agent Skills Last updated: 2026-10-13 Six task-oriented Skills help coding agents use agc-cli safely and consistently. Install all Skills with `agc skills install --agent codex --global`, or select one with `agc skills install --name --agent codex --global`. ## agc-cli-usage - Source: https://github.com/Createitv/agc-cli/tree/main/skills/agc-cli-usage - Direct SKILL.md: https://raw.githubusercontent.com/Createitv/agc-cli/main/skills/agc-cli-usage/SKILL.md - Install: `agc skills install --name agc-cli-usage --agent codex --global` ## agc-auth - Source: https://github.com/Createitv/agc-cli/tree/main/skills/agc-auth - Direct SKILL.md: https://raw.githubusercontent.com/Createitv/agc-cli/main/skills/agc-auth/SKILL.md - Install: `agc skills install --name agc-auth --agent codex --global` ## agc-publishing - Source: https://github.com/Createitv/agc-cli/tree/main/skills/agc-publishing - Direct SKILL.md: https://raw.githubusercontent.com/Createitv/agc-cli/main/skills/agc-publishing/SKILL.md - Install: `agc skills install --name agc-publishing --agent codex --global` ## agc-testing - Source: https://github.com/Createitv/agc-cli/tree/main/skills/agc-testing - Direct SKILL.md: https://raw.githubusercontent.com/Createitv/agc-cli/main/skills/agc-testing/SKILL.md - Install: `agc skills install --name agc-testing --agent codex --global` ## agc-reports - Source: https://github.com/Createitv/agc-cli/tree/main/skills/agc-reports - Direct SKILL.md: https://raw.githubusercontent.com/Createitv/agc-cli/main/skills/agc-reports/SKILL.md - Install: `agc skills install --name agc-reports --agent codex --global` ## agc-cicd - Source: https://github.com/Createitv/agc-cli/tree/main/skills/agc-cicd - Direct SKILL.md: https://raw.githubusercontent.com/Createitv/agc-cli/main/skills/agc-cicd/SKILL.md - Install: `agc skills install --name agc-cicd --agent codex --global` The Skills describe workflows and safety checks. They do not grant Huawei permissions, supply credentials, or prove that a remote action succeeded. --- # agc-cli:鸿蒙与华为 AppGallery Connect 开源命令行工具 agc-cli 是 Createitv 开源的华为 AppGallery Connect 命令行工具,安装后的命令名是 agc。它面向鸿蒙和华为应用开发者,将接口发现、凭据 Profile、请求预演与 API 调用组织成可复用命令,适合需要维护应用资料、测试用户、商品和报表的个人开发者与团队。 ## agc-cli 是华为官方工具吗? 不是。agc-cli 是 Createitv 维护的独立开源项目,使用 MIT 许可证。它基于华为 AppGallery Connect API 参考文档组织接口,不代表华为官方产品或官方支持服务。 ## 如何在 macOS、Windows 和 Linux 安装 agc-cli? 已安装 Node.js 18+ 时,三个系统都可运行 npm install --global @createitv/agc-cli。macOS 也可使用 Homebrew,Windows 也可使用 Scoop。安装后运行 agc version 检查版本。 ## agc-cli 免费吗,需要付费账号吗? agc-cli 使用 MIT 许可证,可免费使用和修改。调用华为 API 需要自己的 AppGallery Connect 账号、凭据和相应权限;华为平台服务的费用和限制以华为说明为准。浏览官网接口和使用 CLI 查看接口定义无需登录。 ## 如何开始第一次应用信息查询? 先用 agc auth login --service-account-file ~/.agc/service-account.json --name production 保存凭据,再用 agc init --app-id YOUR_APP_ID --default-profile production 绑定项目。运行 agc publishing app-info-query --invoke --query appId=YOUR_APP_ID --query lang=zh-CN 预演请求,确认后增加 --dry-run=false 发送请求。接口要求 client_id 时显式补上请求头。 ## 156 个接口是否都完成了生产验证? 156 表示注册表中的接口条目数量,分属 13 个 API 家族,不代表每个接口都已完成生产验证。注册表展示已登记参数和调用入口;完整请求、响应、权限与业务前置条件以每个接口链接的参考文档为准。 ## 默认 dry-run 会修改我的应用吗? 不会。带 --invoke 的接口命令默认构建并预览请求,不发送远程请求。真实调用需显式设置 --dry-run=false;调用前应检查目标应用、所选凭据和参数。 ## 可以把 agc-cli 用在脚本或 AI Agent 中吗? 可以。默认 JSON 输出适合脚本处理,agc capabilities 和 agc endpoints 提供能力发现;agc web-server 提供本地 REST 接口,agc openapi 导出接口契约。命令模板帮助导航,但不能替代业务状态检查或审核判断。 ## 如何安装 agc-cli 的 Codex 或 Claude Agent Skills? 先安装 agc-cli,再运行 agc skills list 查看 6 个任务型 Skills。使用 agc skills install --agent codex --global 安装全部 Skills,或增加 --name agc-publishing 只安装发布 Skill。也可以从官网直接下载对应的 SKILL.md。 ## 项目 Profile 会自动填入所有接口参数吗? 项目配置可以绑定默认凭据 Profile,临时切换时使用 --profile。应用 ID、语言、请求头和请求体等接口参数仍需按接口要求显式提供。不要将 Service Account 私钥或凭据文件提交到 Git。 ## Links - Website: https://agccli.app/ - Source: https://github.com/Createitv/agc-cli - API contracts: https://agccli.app/api-reference.json --- # agc-cli Agent 使用指南 Last updated: 2026-10-13 本文档帮助 Codex、Claude 和其他 Coding Agent 在不猜测命令或泄露凭据的前提下使用 agc-cli。agc-cli 是 Createitv 维护的独立开源项目,不是华为官方产品。 ## 推荐工作流 1. **检查身份与权限** — `agc auth whoami --pretty` 2. **发现能力** — `agc capabilities --pretty` 3. **查看接口** — `agc endpoints --output table` 4. **读取接口文档** — `agc --docs --pretty` 5. **预演请求** — `agc --invoke ...` 6. **明确执行** — `在核对目标、凭据和参数后增加 --dry-run=false` ## 安全边界 - 默认 dry-run 只构建请求,不发送远程变更;真实调用需要显式设置 `--dry-run=false`。 - 不要把 Service Account 私钥、OAuth 密钥、凭据响应或 `~/.agc/credentials.json` 提交到 Git。 - 注册表覆盖不等于每个接口已经完成生产验证;权限、状态和完整模型以接口文档链接为准。 - 上传、提交审核、发布和删除类操作必须由用户明确授权,并在执行后读取远程状态。 ## Agent Skills - [agc-cli-usage](https://github.com/Createitv/agc-cli/tree/main/skills/agc-cli-usage) - [agc-auth](https://github.com/Createitv/agc-cli/tree/main/skills/agc-auth) - [agc-publishing](https://github.com/Createitv/agc-cli/tree/main/skills/agc-publishing) - [agc-testing](https://github.com/Createitv/agc-cli/tree/main/skills/agc-testing) - [agc-reports](https://github.com/Createitv/agc-cli/tree/main/skills/agc-reports) - [agc-cicd](https://github.com/Createitv/agc-cli/tree/main/skills/agc-cicd) 安装全部 Skills: `agc skills install --agent codex --global` ## 机器可读资源 - [llms.txt](https://agccli.app/llms.txt) - [llms-full.txt](https://agccli.app/llms-full.txt) - [Skills index](https://agccli.app/skills.md) - [API contracts](https://agccli.app/api-reference.json) - [Open-source repository](https://github.com/Createitv/agc-cli)