Skip to main content
plugin CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install armorcodex@awesome-codex-plugins
Open on GitHub

What 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 outside src/.
  • 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-plugins

Step 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

Similar plugins

All plugins for Security →

From the same set391

The whole set →
aw1-circuit-breaker The aw1-circuit-breaker plugin checks ASTs and tool-call arguments before Python runs code. Use it to intercept dynamic execution, shell launches, and socket connections. CX Codex ★ 1,596repo stars auto-pilot auto-pilot turns a short Claude request into a one-question-at-a-time intake, saves the answers as project files, and lets a later session pick up where the last one stopped. CX Codex ★ 1,596repo stars atomlane atomlane compiles safe parallel execution plans for builds, test suites, and agent scripts. It runs tasks concurrently only when dependencies permit. CX Codex ★ 1,596repo stars assay assay checks changed web pages by interacting with their controls, then reports the results at the end of the agent’s turn. It helps catch failures after a page edit. CX Codex ★ 1,596repo stars repobrain repobrain builds a knowledge base for a repository and answers code questions with file and line references. Use it to explore an unfamiliar project or trace how its modules connect. CX Codex ★ 1,596repo stars anchor anchor — a discipline pack for Claude and Claude CLI: a skill, 22 slash commands and 5 hooks that keep the agent inside the task and carry project memory across sessions. CX Codex ★ 1,596repo stars alcove The alcove plugin for Claude Code and Codex is a local documentation server with hybrid BM25 and vector search. It retrieves relevant project context on demand. CX Codex ★ 1,596repo stars aiboarding The aiboarding plugin keeps AGENTS.md and CLAUDE.md aligned, tracks lifecycle changes, and audits repository guidance for AI coding agents. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open