ACB-CFG-002: The agent cannot install, enable or sideload extensions

FieldValue
Statusdraft
Severityhigh
Check typestatic
Applies toagent-settings, managed-settings
Profilesstrict-general
Exceptionspermitted

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.

References