# 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)