`AI Integration` README commands contain errors or missing implementations

[edyionescu]

Description

Several commands listed in the AI Integration section of the README either have incorrect syntax or reference subcommands that don't exist in their respective namespaces. This issue tracks all of them in one place.

---

Root cause note

Several of the errors below share the same underlying cause: a subcommand listed in the README doesn't exist in its namespace yet, producing the error:

ERROR (6.3.2+00858) Command "<command>" cannot be resolved.

These are called out individually below so each can be tracked and implemented, but the resolution in each case is the same: if a command isn't yet implemented, the README could note that or be updated to reflect current functionality.

---

Issues

Setup & Management

coldbox ai install --agents=claude
The --agents flag doesn't exist. The correct syntax uses a positional/named parameter:

coldbox ai install agent=claude

The README should be updated to reflect the correct syntax.

---

AI Agents

coldbox ai agents refresh
refresh is not present in the agents namespace. Either the subcommand needs to be implemented, or the README entry should be removed.

---

Guidelines

coldbox ai guidelines install testbox
install is not present in the guidelines namespace.

coldbox ai guidelines add testbox
The command exists but rejects testbox as invalid:

'testbox' is not a valid core guideline. Valid core guidelines: boxlang,cfml,coldbox.

However, the built-in help for this command explicitly lists testbox and wirebox as valid examples:

  **************************************************
  * CommandBox Help for coldbox ai guidelines add
  **************************************************
  coldbox ai guidelines add 

  Add a specific core guideline to the project
  Core guidelines come from coldbox-cli templates
  Examples:
  coldbox ai guidelines add coldbox
  coldbox ai guidelines add testbox
  coldbox ai guidelines add wirebox

          Arguments:
                  required string name (The core guideline name (e.g., coldbox, testbox, wirebox, boxlang, cfml)) 
                  string directory (The target directory (defaults to current directory))

Either testbox and wirebox need to be added as valid core guidelines, or the help text and argument description need to be corrected to reflect the actual valid values.

coldbox ai guidelines uninstall testbox
uninstall is not present in the guidelines namespace.

---

Skills

coldbox ai skills install creating-handlers
install is not present in the skills namespace.

coldbox ai skills uninstall async-programming
uninstall is not present in the skills namespace.

---

MCP Servers

coldbox ai mcp info
info is not present in the mcp namespace.

coldbox ai mcp config
config is not present in the mcp namespace.

---

What are the steps to reproduce this issue?

1. Install coldbox-cli version 8.8.0+25
2. Run any of the commands listed in the Issues section above
3. For coldbox ai install --agents=claude, observe the flag is not recognised; for all others, observe the cannot be resolved error

What happens?

coldbox ai install --agents=claude silently ignores the --agents flag or errors. All other listed commands fail with:

ERROR (6.3.2+00858) Command "<command>" cannot be resolved.

What were you expecting to happen?

Ideally, each of these commands would work as documented. Where a command isn't yet implemented, the README could note that or be updated to reflect current functionality.

Any logs, error output, etc?

ERROR (6.3.2+00858) Command "coldbox ai agents refresh" cannot be resolved.
ERROR (6.3.2+00858) Command "coldbox ai guidelines install" cannot be resolved.
ERROR (6.3.2+00858) Command "coldbox ai guidelines uninstall" cannot be resolved.
ERROR (6.3.2+00858) Command "coldbox ai skills install" cannot be resolved.
ERROR (6.3.2+00858) Command "coldbox ai skills uninstall" cannot be resolved.
ERROR (6.3.2+00858) Command "coldbox ai mcp info" cannot be resolved.
ERROR (6.3.2+00858) Command "coldbox ai mcp config" cannot be resolved.

Any other comments?

Some of these commands were discovered via the Agentic ColdBox docs page and the ColdBox AI announcement blog post, so users following those resources will hit these errors. The docs page in particular may be worth revisiting once fixes land.

What versions are you using?

Operating System: Windows 11 Pro 25H2
Package Version: coldbox-cli 8.8.0+25