# GoPlus AgentGuard

Security framework for AI agents. Provides code scanning, runtime action evaluation, and trust management.

## Skill

This project provides a unified Claude Code skill: `/agentguard`

```
/agentguard scan <path>          — Scan code for security risks (24 detection rules)
/agentguard action <description> — Evaluate runtime action safety (allow/deny/confirm)
/agentguard patrol [run|setup|status] — Daily security patrol for OpenClaw environments
/agentguard trust <subcommand>   — Manage skill trust levels (lookup/attest/revoke/list)
/agentguard report               — View security event audit log
/agentguard config <level>       — Set protection level (strict/balanced/permissive)
```

## Project Structure

- `skills/agentguard/` — Claude Code skill definition and supporting files
- `src/` — TypeScript source (scanner rules, registry, action detectors, MCP server)
- `data/` — Registry storage (`registry.json`)
- `dist/` — Compiled JavaScript output

## Setup for Trust & Action CLI

The `trust` and `action` subcommands use CLI scripts that require the agentguard package:

```bash
cd skills/agentguard/scripts && npm install
```

For GoPlus API (optional Web3 enhancement for action evaluation):

```bash
export GOPLUS_API_KEY=your_key
export GOPLUS_API_SECRET=your_secret
```