Skip to content

Quick Start

Requires Node.js >= 18. No account needed.

Install

bash
npm install -g guardclaw
guardclaw start

Takes about 30 seconds. First launch opens an interactive setup wizard.

Setup Wizard

The wizard walks you through three choices:

  1. Cloud judge — pick a cloud provider, auth method, and model
  2. Response modeAuto (flag and block risky calls) or Monitor only (log without blocking)
  3. Agent connections — auto-detects installed agents and installs hooks/plugins with one confirm

Re-run any time with:

bash
guardclaw setup

Restart your AI agent after installing hooks.

Dashboard

Once running, open the dashboard at localhost:3002.

The dashboard shows:

  • Live event timeline with risk scores
  • Per-session tool call history
  • Blocking toggle (on/off without restart)
  • Settings panel for LLM backend configuration

Risk Tiers

ScoreVerdictBehavior
1–3SAFERuns normally
4–7WARNINGLogged with elevated audit signal
8–10HIGH RISKBlocked / requires approval

Uninstall

bash
guardclaw stop
npm uninstall -g guardclaw
node scripts/install-claude-code.js --uninstall  # remove hooks

Released under the MIT License.