Metadata-Version: 2.4
Name: agentshield-cli
Version: 0.1.0
Summary: Mode 1 AgentShield Clean CLI
Project-URL: Homepage, https://github.com/tomo-inc/agent-shield-monorepo
Project-URL: Repository, https://github.com/tomo-inc/agent-shield-monorepo
Project-URL: Issues, https://github.com/tomo-inc/agent-shield-monorepo/issues
Author: Tomo
Keywords: agentshield,cli,qa,quality-gate
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.11
Requires-Dist: pydantic<3.0,>=2.10
Requires-Dist: pyyaml<7.0,>=6.0
Provides-Extra: dev
Requires-Dist: pyright<2.0,>=1.1.396; extra == 'dev'
Requires-Dist: pytest<9.0,>=8.3; extra == 'dev'
Requires-Dist: ruff<1.0,>=0.11; extra == 'dev'
Description-Content-Type: text/markdown

# AgentShield CLI

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

## Public Commands

```text
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`

```bash
uv tool install agentshield-cli
```

### macOS or Windows with `pipx`

```bash
pipx install agentshield-cli
```

### Local Development Install From This Monorepo

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

## Usage

From the target repository root:

```bash
agentshield init --yes
agentshield check --strict
```

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

```bash
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.
