ACB-CFG-002: The agent cannot install, enable or sideload extensions
| Field | Value |
|---|---|
| Status | draft |
| Severity | high |
| Check type | static |
| Applies to | agent-settings, managed-settings |
| Profiles | strict-general |
| Exceptions | permitted |
Description
Installing or enabling an extension requires a human action outside the agent's own tool calls. The committed permission configuration denies the agent the client's extension install and management commands, and managed policy, where present, stops extensions from loading outside the managed install path, including extension code the agent writes itself.
Rationale
An agent that can install or load extensions can give itself new code running in its own host with the user's privileges, and an agent that can write extension code and have it loaded can do the same without any install step. Either way the agent decides what oversees it. Extension installation is a privilege decision that belongs to a person.
Audit procedures
install-commands-denied (structure)
Collect the deny rules from every agent settings file in the repository. For every extension install rule group the client defines, at least one of its rules is present.
managed-sideload-disabled (structure)
Every managed settings file holds the client's sideload restriction values. Not applicable when the repository contains no managed settings file.
Remediation
Deny the extension install and management commands in committed settings, and set the sideload restriction in managed policy so that extensions load only from the managed install path.
Implementation notes
Client-specific facts from clients/; the control above is the requirement.
claude-code: install-commands-denied
Plugins, including mods, install with `claude plugin install` from a shell or `/plugin install` in a session. Bash rule patterns match the command as written, so a deny rule does not catch every spelling (for example an absolute path to the binary); the managed sideload restriction is the stronger layer.
claude-code: managed-sideload-disabled
disableSideloadFlags in managed settings rejects --plugin-dir and --plugin-url and keeps mods that Claude writes during a session from loading.