Claude Code hook

armorClaude

Intent-based security plugin for Claude Code - registers a plan per prompt and enforces policy on every tool call via hooks.

47 stars 3 forksHooks Plugin marketplace Source

Install

Install
claude plugin marketplace add armoriq/armorClaude

Found in the project README. Check it for setup steps after installing.

From source
git clone https://github.com/armoriq/armorClaude.git

From the README

ArmorClaude

ArmorIQ intent-based security enforcement plugin for Claude Code and Claude Cowork. Enforces that an AI agent declares what it intends to do before doing it, and every action is checked against that declared intent.

How It Works

1. Before the agent acts: Intercepts prompts, captures a structured plan (from Claude's built-in plan mode or an LLM fallback call), and sends it to ArmorIQ IAP for a signed intent token.
2. On every tool call: Checks the tool against the approved plan, verifies the token hasn't expired, evaluates local policy rules (allow/deny by tool name, data classification like PCI/PII), and optionally verifies CSRG cryptographic proofs. Blocks execution if any check fails.
3. After tool execution: Sends audit logs to ArmorIQ IAP for compliance tracking.
4. Fail-closed: If planning fails, identity is missing, or the token is invalid — all tool calls are blocked by default.

Install

One-line install (recommended)

This adds the armoriq Claude Code marketplace and installs the armorclaude plugin. Dependencies are installed automatically on first hook fire.

Manual install (Claude Code marketplace)

Verify

First-run behavior

The plugin ships its Node dependencies uninstalled. On the first launch (first hook fire or
first MCP-server start), scripts/bootstrap.mjs performs a one-time npm install and prints
to stderr:

- Requires Node.js >= 20 and npm on PATH, plus network access on that first run.
- The bundled MCP server (armorclaude-policy) registers once dependencies finish installing;
  it stays connected on subsequent runs without reinstalling.
- No API key is needed to start. With api_key blank the plugin runs in local-only mode
  (no data leaves your machine — see Data & Privacy); a key only adds backend
  audit, intent tokens, and CSRG…
Read the full README on GitHub

How hooks work

  • Hooks are shell commands Claude Code runs at fixed points: before or after a tool call, when you submit a prompt, when Claude stops, on notifications and at session start.
  • They are set in the hooks section of ~/.claude/settings.json (or .claude/settings.json for a project), or come bundled in a plugin.
  • A hook can block a tool call, add context, or run a formatter or test. Read the scripts before you install them: they run on your machine with your permissions.
Claude Code docs

Details

Type
Hooks
Language
JavaScript
License
MIT
Last updated
3 November 2026

FAQ

What is armorClaude?

Intent-based security plugin for Claude Code - registers a plan per prompt and enforces policy on every tool call via hooks. It is a hook for Claude Code, from armoriq/armorClaude on GitHub.

How do I install armorClaude?

Run claude plugin marketplace add armoriq/armorClaude, then follow the setup in the README.

Is armorClaude popular?

armoriq/armorClaude has 47 GitHub stars and 3 forks. It was last updated on 3 November 2026.

More hooks

Browse the most popular Claude Code mods, all hooks, or the skills and MCP server directories.