From 284f9bde57a3221d5806d93dedddc6ad916b8e3a Mon Sep 17 00:00:00 2001 From: "shopware-docs-updater[bot]" <313750211+shopware-docs-updater[bot]@users.noreply.github.com> Date: Thu, 15 Oct 2026 13:13:30 +0000 Subject: [PATCH] docs(cli): document AI client skill recommendation and --no-ai-hint Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- products/tools/cli/installation.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/products/tools/cli/installation.md b/products/tools/cli/installation.md index ea514f540c..7989d4d295 100644 --- a/products/tools/cli/installation.md +++ b/products/tools/cli/installation.md @@ -183,6 +183,24 @@ To disable it for the current shell session (or persistently, by adding it to yo export SHOPWARE_CLI_NO_UPDATE_NOTIFICATION=true ``` +## AI client skill recommendation + +When Shopware CLI is invoked by a supported AI coding agent (detected from the `AI_AGENT` environment variable set by the agent itself) and its `shopware-cli` skill is not yet installed for that client, the CLI prints a short, non-blocking recommendation to stderr pointing at the `shopware-cli ai add` command. See [AI agent skills](https://github.com/shopware/shopware-cli/blob/main/docs/AGENT_SKILLS.md) for details on the `ai` command group. It never installs anything automatically and is shown at most once per client every 24 hours. + +It stays silent when: + +- no AI client is detected +- `CI` is set +- `--no-ai-hint` is passed +- the invoked command is itself an `ai …` command +- the skill is already installed for that client + +To silence it for a single command, pass `--no-ai-hint`: + +```bash +shopware-cli --no-ai-hint +``` + ## Environment variables ### Authentication and configuration