ArmorCodex icon

ArmorCodex

armoriq/armorcodex · v0.3.9 · Development & Workflow

by ArmorIQOwner verifiedAwesome AI Plugins

Intent-based security for Codex with MCP plan registration, policy gating, CSRG cryptographic proofs, and audit logging on bash and apply_patch.

Follow0
Protect this install with HOL Guard

Guard checks the skills and MCP servers a plugin adds on your machine and asks you before a risky action runs. The scores above are free, and no plan changes them.

Is ArmorCodex a fit?

From the plugin's manifest and HOL's scan. Anything the plugin does not declare is shown as not declared.

Works with

  • MCP
  • Codex
  • 1 MCP server
  • Runs hooks on agent events

Before you install

Sign-in
Asks you to sign in when you install it
Settings it asks for
Enforcement Mode, Require Intent Plan, Enable Crypto Policy Binding, Use Production Endpoints and 2 more
Declared access
Not declared
License
MIT

Check before relying on it

What is ArmorCodex?

ArmorCodex is a published development & workflow plugin for AI coding agents that works with MCP and Codex, developed by ArmorIQ and distributed through the HOL AI plugin registry. Intent-based security for Codex with MCP plan registration, policy gating, CSRG cryptographic proofs, and audit logging on `bash` and `apply_patch`.

Canonical slug
armoriq/armorcodex
Version
v0.3.9 · updated Nov 18, 2026

Registry snapshot

Owner verification
Verified on HOL as @Harihara04sudhan
Marketplace source
.agents/plugins/marketplace.json
Scanner
HOL plugin scanner
Security result
Partial scan
Digest verified
Yes

Trust and security

Trust & reputation

On-Chain Verified
93

HOL Trust Score

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability
100/100
Maintenance
100/100
MCP server setup
100/100
Plugin Security
92/100
Provenance
80/100
Publisher Quality
100/100

Provenance

Plugin root
plugins/armorcodex
Source repo
https://github.com/armoriq/armorCodex
Source commit
e8a4d7ac8e92…
Publisher verified
Yes
Owner verified
@Harihara04sudhan
Agent Plugins 1.0
Not detected

Continuous scanner CI detected

No action is required. This plugin receives the full trust score.

README badge not detected

Plugin owners can add the HOL badge to the repository README from Guard Plugins. Distribution, not security evidence. It adds a 2% engagement adjustment to the overall trust score and never changes the security result.

Partial scan
Security result
92
Score from finished checks
0
High findings

Some checks did not finish: Cisco MCP scan. No blocking issue was found in the checks that did finish, but this is not a passed scan.

Provider
codex-plugin-scanner
Grade
A · Excellent
Version
3.24.2
cisco-skill-scanner: skippedcisco-mcp-scanner: unavailable

Manifest Validation

28/31

9 checks

Security

20/20

9 checks

Operational Security

6/6

5 checks

Best Practices

6/9

5 checks

Marketplace

N/A

3 checks · not applicable

Skill Security

N/A

3 checks · not applicable

Code Quality

10/10

2 checks

Published advisories

None matched in GitHub security advisories, checked . This covers published advisories only, not problems nobody has reported.

GitHub security advisories are those the source repository has published.

Findings

infomanifest-validationPLUGIN_JSON_INTERFACE_ASSET_SCREENSHOTS

The interface field "screenshots" must use HTTPS or point to a safe in-repo asset.

Update "screenshots" to use HTTPS or an existing relative asset path.

infobest-practicesCODEXIGNORE_MISSING

A .codexignore file helps prevent accidental inclusion of local artifacts and secrets.

Add a .codexignore file with generated assets, local state, and secret paths.

Install guidance

Install in Codex

Install through the Codex CLI plugin marketplace.

Codex plugin docs

Optional: install HOL Guard for Codex first, so it can check this plugin's tools on your machine before Codex uses them.

  1. 1

    Register the marketplace

    Run in any terminal. Codex reads the marketplace entry from .agents/plugins/marketplace.json (or the legacy .claude-plugin path) in the repository. If the repository ships none, add the generated entry from the Advanced section below first.

    shell
  2. 2

    Install the plugin

    Installs the armorcodex entry from the armorcodex marketplace. You can also install it from the Plugins browser inside Codex.

    shell
  3. 3

    Check the marketplace is registered

    This confirms the marketplace source only. Confirm the plugin itself is enabled in the Plugins browser before relying on it.

    shell

To remove it later, run codex plugin remove armorcodex@armorcodex.

Did setup work in Codex?

No setup reports for Codex yet. Self-reported by signed-in visitors. Copying a command is not counted, and most installs are never reported.

Attested installs: Fewer than 10 attested installs of this plugin in week 2026-W46, so no number is shown. Counted from opt-in HOL Guard install reports, once per machine and runtime, and never mixed with the answers above. How install reports work.

Loading reviews

Plugin manifest

{
  "name": "armorcodex",
  "version": "0.3.9",
  "description": "ArmorIQ intent-based security enforcement for Codex: Bash command guardrails with intent verification, optional CSRG cryptographic proofs, and audit logging. Codex hooks currently fire for Bash, apply_patch, and MCP tool calls; non-Bash file/web activity may need supplemental controls. See CODEX_HARNESS_LIMITATIONS.md.",
  "author": {
    "name": "ArmorIQ",
    "email": "[email protected]",
    "url": "https://armoriq.ai"
  },
  "homepage": "https://armoriq.ai",
  "repository": "https://github.com/armoriq/armorCodex",
  "license": "MIT",
  "keywords": [
    "security",
    "policy",
    "audit",
    "intent",
    "armoriq",
    "mcp",
    "hooks"
  ],
  "hooks": "./.codex/hooks.json",
  "mcpServers": "./.registry/mcp.json",
  "interface": {
    "displayName": "ArmorCodex",
    "developerName": "ArmorIQ",
    "shortDescription": "Intent-based security policy and audit for Codex.",
    "longDescription": "ArmorIQ intent-based security enforcement for OpenAI Codex. Treat as a strong Bash guardrail and audit layer, not a complete boundary for every Codex capability. Codex hooks currently emit Bash, apply_patch, and MCP tool calls. ArmorCodex provides plan registration through MCP, intent-plan matching, permission gating, and post-run audit on those tools. Non-Bash activity (file edits, web search, app connectors) is gated where Codex emits hook events.",
    "category": "Security",
    "capabilities": [
      "MCP",
      "Hooks"
    ],
    "websiteURL": "https://armoriq.ai",
    "privacyPolicyURL": "https://armoriq.ai/privacy-policy",
    "termsOfServiceURL": "https://armoriq.ai/terms-of-service",
    "brandColor": "#00E5CC",
    "composerIcon": "./assets/armoriq-logo.png",
    "logo": "./assets/armoriq-logo.png",
    "defaultPrompt": [
      "Show me what security rules are protecting this project.",
      "Block any commands that fetch URLs or exfiltrate data.",
      "Walk me through your plan before running anything."
    ]
  },
  "userConfig": {
    "mode": {
      "type": "string",
      "title": "Enforcement Mode",
      "description": "enforce = block on policy/intent failures (recommended). monitor = log only, never block.",
      "sensitive": false
    },
    "intent_required": {
      "type": "boolean",
      "title": "Require Intent Plan",
      "description": "When true, every Bash command must be backed by a registered intent plan (Codex hooks currently only intercept Bash). Disable for advisory-only use.",
      "sensitive": false
    },
    "crypto_policy_enabled": {
      "type": "boolean",
      "title": "Enable Crypto Policy Binding",
      "description": "Bind policy rules to a Merkle tree so post-issuance tampering is detected.",
      "sensitive": false
    },
    "use_production": {
      "type": "boolean",
      "title": "Use Production Endpoints",
      "description": "When true, talks to ArmorIQ production. When false, expects a local backend on 127.0.0.1.",
      "sensitive": false
    },
    "disable_observability": {
      "type": "boolean",
      "title": "Disable observability",
      "description": "Observability (execution traces sent to your ArmorIQ dashboard) is enabled by default. Set to true to turn it off.",
      "sensitive": false
    },
    "disable_usage_sync": {
      "type": "boolean",
      "title": "Disable token usage sync",
      "description": "Applies only while observability is enabled. The usage sync uploads token counts from every local Codex session in ~/.codex/sessions to your ArmorIQ dashboard. Set to true to turn it off. Turning off observability turns it off too.",
      "sensitive": false
    }
  },
  "holManifestOrigin": "repository",
  "registryIndexVersion": 9
}

Marketplace source

Repo URL
https://github.com/armoriq/armorCodex
Marketplace path
.agents/plugins/marketplace.json
Source path
plugins/armoriq/armorCodex
Install policy
AVAILABLE

File inventory

.codex-plugin/plugin.json

plugin-manifest

3,251 bytes

af51069fc7667fa8…

.codex/hooks.json

file

2,190 bytes

0c68a5ca9cc25cfc…

.github/dependabot.yml

file

472 bytes

3fa3565a566106a1…

.mcp.json

file

135 bytes

6c4f9e3621ba07c0…

.registry/mcp.json

mcp-config

96 bytes

769c471da05c5152…

assets/armoriq-logo.png

asset

9,292 bytes

bfedc70745374a3c…

hooks/hooks.json

file

1,775 bytes

ba35ca428ce32378…

LICENSE

file

1,428 bytes

45ab3001573421d8…

package-lock.json

file

63,581 bytes

12a4f6f01819f3dd…

package.json

file

452 bytes

4dd3d8fe807d9b7c…

README.md

file

1,807 bytes

31b211c99b3717f4…

SECURITY.md

file

1,250 bytes

9994da5baab1eff3…

ArmorCodex — Frequently asked questions

What is ArmorCodex?
ArmorCodex is an AI plugin in the HOL registry. Intent-based security for Codex with MCP plan registration, policy gating, CSRG cryptographic proofs, and audit logging on bash and applypatch.
How do I install ArmorCodex?
Install ArmorCodex in your harness: Codex — codex plugin marketplace add armoriq/armorCodex; MCP — git clone https://github.com/armoriq/armorCodex. Full step-by-step guidance is on the HOL plugin page.
How do I install ArmorCodex in HOL Guard?
To install ArmorCodex in HOL Guard, start with hol-guard plugin install armoriq/armorcodex --apply. The complete step-by-step install guide for HOL Guard is on the HOL plugin page.
How do I install ArmorCodex in Codex?
To install ArmorCodex in Codex, start with codex plugin marketplace add armoriq/armorCodex. The complete step-by-step install guide for Codex is on the HOL plugin page.
How do I install ArmorCodex in MCP?
To install ArmorCodex in MCP, start with git clone https://github.com/armoriq/armorCodex. The complete step-by-step install guide for MCP is on the HOL plugin page.
How is the Trust Score for ArmorCodex computed?
ArmorCodex has a HOL Trust Score of 93 out of 100. The score is a weighted sum of six components from a static scan of the source, capped for high-severity findings and adjusted by two disclosed policies. Memberships and payments are not inputs, and a scan is not a safety guarantee. Full breakdown: https://hol.org/registry/plugins/armoriq%2Farmorcodex/trust
Who publishes ArmorCodex?
ArmorCodex is published by ArmorIQ and listed on HOL.

Directory acceptance

Listed in 1 of 5 directory lists

Read from the list each directory publishes on GitHub. Being listed means the directory accepted the plugin; it is not a HOL security rating.

Lists last read . HOL re-reads them every day.

Submitting it? Check it against each directory's rules

Install signal

HOL cannot see every install. These are separate signals from different sources, so they are not added together. Counts under each floor show as <N.

Install commands issued here
<5
HOL Guard install commands issued from this listing, last 28 days.
Opt-in install reports
<10
Machines that reported installing it through HOL Guard in week 2026-W46. Reporting is opt-in, so most installs are not counted.
HOL Guard workspaces
<5
Workspaces that approved it or include it in an approved-plugin feed, as of today.
New GitHub stars
<5
From HOL's GitHub snapshots of the repository, 2026-10-23 to 2026-11-20.

Reviews and similar plugins