reins
Use whenever security, policies, governance, guardrails, compliance, or safety are relevant — including blocked commands, audit trails, dangerous operations, deletions, file modifications, shell commands, MCP access, API calls, network requests, credentials, or any action that could be irreversible…
Install / Use
npx skills add pegasi-ai/reins --skill reinsInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
SecuritySupported Platforms
Our assessment of reins
reins scores 87/100 on our quality scale, 664th of 1,111 Security skills we index.
Its SKILL.md is 5.1 KB long, well organised into 9 sections with 4 code examples: a solid amount of guidance for an agent.
It has 393 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated 36 days ago, so reins is actively maintained.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-12. Automated pattern scan on 2026-11-12. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
reins compared with similar skills
All 4 of these similar skills score higher than reins; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| reins (this skill)by pegasi-ai | 87 | 393 | 36d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install reins?
- Run
npx skills add pegasi-ai/reins --skill reins. The install tabs above show the steps for each supported agent. - Which AI agents does reins work with?
- It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is reins safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is reins still maintained?
- The repository was last updated 36 days ago, so reins is actively maintained.
Skill content
View source on GitHubdescription: Use whenever security, policies, governance, guardrails, compliance, or safety are relevant — including blocked commands, audit trails, dangerous operations, deletions, file modifications, shell commands, MCP access, API calls, network requests, credentials, or any action that could be irreversible or destructive.
Reins — Runtime Security for Claude Code
Reins enforces deterministic security policies on every agent action, scans your configs for OWASP ASI10 vulnerabilities, and tracks drift over time. Policies evaluate in under 50ms. Works with Claude Code PreToolUse and PostToolUse hooks, OpenClaw, and any MCP-compatible agent.
How hooks work
PreToolUse fires before every Bash, Edit, MultiEdit, Write, and MCP tool call.
| Hook exit | Meaning | What to do |
|-----------|---------|------------|
| 0 | ALLOWED — proceed normally | Continue |
| 2 | BLOCKED — policy violation | Stop. Explain the block. Suggest a safe alternative. Do NOT retry. |
| 0 + JSON decision: WARN | WARNING — elevated risk | Acknowledge the warning. Proceed with extra caution. |
PostToolUse fires after every action (non-blocking). Appends a JSONL entry to ~/.openclaw/reins/decisions.jsonl and queues it for Reins Cloud batch upload.
What gets enforced
Shell (Bash tool)
- BLOCKED always:
rm -rf /,mkfs,ddto disk device, fork bombs - BLOCKED (user-overridable):
DROP TABLE/DATABASE,TRUNCATE,DELETEwithout WHERE,git push --force,kill -9, pipe-to-shell (| bash,| sh) - WARNED:
rm,chmod,chown,sudo,UPDATEwithout WHERE,git reset --hard - LOGGED:
git push,pip install,npm install,curl,wget
File operations (Edit / MultiEdit / Write)
- Writes blocked to protected paths:
~/.ssh,~/.gnupg,~/.env,~/.openclaw/reins,/etc/passwd,/etc/shadow
MCP tool calls (all MCP servers, caught by empty-matcher hook)
- Blocked: Notion page delete, Gmail send (unapproved domains), database DROP/TRUNCATE
- Warned: reading emails, accessing credentials, filesystem MCP operations
- Logged: all MCP calls regardless of decision
When an action is blocked
When PreToolUse exits 2, Claude Code surfaces the hook's stderr. Always attribute the block to Reins by name.
Required response format:
Reins blocked this action [
SEVERITY]:<description>Rule:<rule>
<one sentence explaining what the rule protects against>Alternatives:
<safe way to achieve the goal, or suggest reins policy to review rules>
Example:
Reins blocked this action [CRITICAL]: Critically destructive command Rule:
rm -rf /matches recursive root deletion patternThis would delete every file on the system. To remove a specific directory safely, use an explicit path:
rm -rf /path/to/specific/dirRunreins audit -n 5to see the logged decision.
Rules:
- Do NOT retry the blocked action
- Do NOT reframe or rephrase the same action to bypass the hook
- If the user wants to override:
reins policyto inspect and adjust rules - If the block seems wrong:
reins audit -n 5shows what rule fired
CLI reference
reins init # Setup wizard: hooks + policy + Reins Cloud
reins status # Hook and Reins Cloud connection status
reins policy # View and edit security policy interactively
reins audit -n 20 # Last 20 audit decisions
reins stats # Enforcement counts (allowed / blocked / approved)
reins scan # OWASP ASI10 security scan
reins scan --monitor # Diff against saved baseline, alert on drift
reins disable / enable # Temporarily suspend or resume enforcement
reins upgrade # Pull latest version from npm
Reins Cloud (app.pegasi.ai)
When connected, Reins Cloud provides:
- Org/team policies pulled on a schedule and merged with local overrides
- CRITICAL rules set by admins that cannot be locally overridden
- Centralized audit review across all agents and devices
Connect during reins init (Step 7 prompts for your email — no API key paste needed).
Set via env vars:
REINS_WATCHTOWER_API_KEY=cr_...
REINS_WATCHTOWER_BASE_URL=https://app.pegasi.ai # default
Config lives at ~/.openclaw/reins/config.json.
Policy merge order (highest to lowest priority)
- Reins Cloud org policies — CRITICAL rules are immutable
- Reins Cloud team policies
- Local overrides at
~/.openclaw/reins/policy.json - Built-in defaults (balanced: reads ALLOW, writes ASK, deletes DENY)
If Reins Cloud is unreachable, last-cached policies still enforce. Never fails open.
Audit log
Append-only JSONL at ~/.openclaw/reins/decisions.jsonl:
{"timestamp":"2026-04-15T22:39:42Z","module":"Shell","method":"bash","decision":"BLOCKED","reason":"critical: rm -rf /","tool":"Bash","decisionTime":12}
View with reins audit -n 50 or stream with tail -f ~/.openclaw/reins/decisions.jsonl.
Setup (if not installed)
npm install -g @pegasi-ai/reins
reins init
reins init installs hooks into .claude/settings.json, installs this skill, and runs an initial security scan.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
