AgentShield CLI

AgentShield CLI is the installable command-line package for running QA gate checks against a target repository.

Public Commands

agentshield init --yes
agentshield check --strict

init --yes scans the current repository and writes .agentshield/config.yaml.

check --strict loads .agentshield/config.yaml and runs the configured checks. If the config file is missing, check auto-initializes unless --no-init is set.

Install

The commands below work after agentshield-cli has been published to PyPI or to your organization's private package index.

macOS or Windows with uv

uv tool install agentshield-cli

macOS or Windows with pipx

pipx install agentshield-cli

Local Development Install From This Monorepo

uv tool install --from ./packages/cli agentshield-cli

Usage

From the target repository root:

agentshield init --yes
agentshield check --strict

If the repository already contains .agentshield/config.yaml, initialization is not required:

agentshield check --strict

Notes

• The public command surface is intentionally small: check and init.
• The analyzer exists internally, but external users do not need to learn a separate scan command.
• Generated checks prefer argv arrays for better macOS and Windows compatibility.