docsGetting Started

Getting Started

Prerequisites

  • Node.js >= 18.0.0
  • Claude Code

Install

npm install -g @pegasi-ai/reins
reins init

reins init runs an interactive wizard that:

  1. Chooses a security level: permissive / balanced / strict / custom
  2. Selects modules to protect: FileSystem, Shell, Browser, Network
  3. Installs PreToolUse + PostToolUse hooks into .claude/settings.json
  4. Installs the Claude Code skill to ~/.claude/skills/reins/SKILL.md
  5. Optionally connects to Reins Cloud for centralized policy management
  6. Runs an initial environment security scan (reins scan)

See Claude Code for hook details, the skill, and examples.

Non-interactive install

For CI or scripted environments:

reins init --non-interactive --security-level balanced --modules FileSystem,Shell

Machine-readable output:

reins init --non-interactive --json

Building from source

git clone https://github.com/pegasi-ai/reins
cd reins
npm install
npm run build
 
# Link for global use
npm link
reins --help

After any code change: npm run build — no re-registration needed.

Verify

reins status   # hook status + Reins Cloud connection
reins scan     # 13-check security audit
reins audit    # last 50 decisions
OverviewClaude Code