ArmorCodex — Claude Code & Codex plugin: what it does, how to install
armorcodex is a Claude Code plugin that checks Bash, apply_patch and MCP tool calls against a declared intent plan and policy rules.
MIT ★ 1,596 updated 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install armorcodex@awesome-codex-pluginsWhat armorcodex does
Claude gets a set of hooks. On session start and on prompt submission the plugin pushes the agent to file an intent plan over MCP before anything else runs. preToolUse compares each call with that plan and the policy, and answers with a deny decision when a call drifts or breaks a rule. postToolUse writes an audit record to the ArmorIQ backend.
The bundle holds the manifest .codex-plugin/plugin.json, Claude config in .codex/, an MCP registration for armorcodex-policy in .mcp.json, plus hook scripts and a router under scripts/. MCP tools: register_intent_plan, policy_update for plain-language rules, policy_read. A permissionRequest hook applies the policy before the user is asked.
Codex fires hooks on Bash, apply_patch and MCP tool calls. Other file edits and web traffic slip past, so those need separate controls. Setup runs through install_armorcodex.sh or the Claude marketplace; in Claude the plugin comes from the awesome-codex-plugins marketplace.
What it helps with
- block tool calls that drift from the declared plan
- write security rules in plain language
- keep an audit trail of Bash calls
- deny a risky command before the user is prompted
- lock session intent before the first tool fires
Example prompts for the agent
- Register an intent plan for this task with
register_intent_plan, then start editing. - Add a rule through
policy_update: nothing outsidesrc/. - Show me the current rules with
policy_read.
How to install armorcodex
Plugin marketplace
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install armorcodex@awesome-codex-pluginsStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about armorcodex
How do I install armorcodex in Claude Code?
Add the marketplace first: /plugin marketplace add hashgraph-online/awesome-codex-plugins. Then install the plugin: /plugin install armorcodex@awesome-codex-plugins.
What does armorcodex do?
It checks tool calls against an intent plan and policy rules, denies calls outside the plan, and sends audit records to the ArmorIQ backend.
Which Claude calls do the hooks cover?
Bash, apply_patch and MCP tool calls. Other file edits and web activity sit outside that gate and need separate controls.
Source text
armorCodex · MIT
# ArmorCodex
Intent-based security enforcement for OpenAI Codex. Hooks Codex's `Bash`, `apply_patch`, and MCP tool calls against a declared intent plan and policy rules. Blocks intent-drift, gates by natural-language policy rules, and ships signed audit logs to the ArmorIQ backend.
This directory is the plugin bundle. The full project lives at the repository root.
## Install
```bash
curl -fsSL https://armoriq.ai/install_armorcodex.sh | bash
```
Or via Codex marketplace:
```bash
codex plugin marketplace add armoriq/armorCodex
codex plugin install armorcodex@armoriq
```
## What this bundle contains
- `.codex-plugin/plugin.json` plugin manifest (Codex spec)
- `.codex/` Codex-specific config
- `.mcp.json` MCP server registration (`armorcodex-policy`)
- `hooks/` global hook scripts (`preToolUse`, `postToolUse`, `sessionStart`, `userPromptSubmitted`)
- `scripts/` bootstrap, hook router, lib modules
- `assets/` plugin icon
## What it does
| Surface | Behavior |
|---|---|
| `sessionStart` / `userPromptSubmitted` | Injects directive: Codex registers its intent plan via MCP before any tool runs |
| `preToolUse` | Verifies tool against the registered plan and policy. Returns `{"permissionDecision":"deny",...}` for out-of-plan or policy-denied calls. |
| `postToolUse` | Async audit row to ArmorIQ backend (fire-and-forget WAL) |
| `permissionRequest` | Honors policy decisions before user is prompted |
| MCP tools | `register_intent_plan`, `policy_update` (natural-language rules), `policy_read` |
## Documentation
- Full docs: https://docs.armoriq.ai/armorcodex
- Source repo: https://github.com/armoriq/armorCodex
- ArmorIQ platform: https://armoriq.ai
© ArmorIQ · MIT · hashgraph-online/awesome-codex-plugins