vigil
oleh robinoppenstam
Git & GitHubRingkasan
AI agent safety guardrails for tool calls.
Deskripsi
Apa yang Dilakukan Skill Ini
Vigil validates AI agent tool calls before they execute, blocking operations like destructive shell commands, SSRF, SQL injection, path traversal, and credential leaks. It runs as a drop-in npm package with 22 rules, zero runtime dependencies, and under 2ms latency per check.
Zero runtime dependencies and sub-2ms latency mean it can run inline on every tool call without adding measurable overhead to the agent pipeline.
Kapan Menggunakannya
- Blocking rm -rf commands issued by autonomous agents
- Preventing SSRF in agent-driven API and HTTP calls
- Catching SQL injection before a database tool executes
- Auditing all tool calls made by a shell-executing agent
- Adding a safety layer to an existing MCP server
Contoh Alur Kerja
User asks: validate a shell command before my agent runs it
- 1
Import checkAction from vigil-agent-safety
- 2
Pass the tool name and params object to checkAction
- 3
Receive a decision (ALLOW, BLOCK, or ESCALATE) with a reason string
- 4
Block execution or proceed based on the returned decision
BLOCK: Destructive command pattern — the rm -rf / call is rejected before execution
Persyaratan
- vigil-agent-safety npm package
Instalasi
clawhub install robinoppenstam/vigilJalankan perintah CLI-nya, atau tempel prompt ke Claude Code, Cursor, Codex, atau coding agent apa pun yang Anda pakai.