ArmorClaudeGetting Started

Command Reference

Complete reference for all /armorclaude:armor commands available in ArmorClaude

/armorclaude:armor Command Reference

All ArmorClaude commands start with /armorclaude:armor. Type /armorclaude:armor alone to see the help text. Commands are handled through UserPromptSubmit or UserPromptExpansion. Policy parsing does not require a separate model call.

Use /armorclaude:armor only. The legacy /armor-policy prefix is intentionally unsupported.

Quick Reference

CommandDescription
/armorclaude:armorShow help
/armorclaude:armor yesApply the current staged proposal
/armorclaude:armor noDiscard the current staged proposal

Policy Commands

Viewing Policy

CommandDescription
/armorclaude:armor policy listShow all rules with IDs and effects
/armorclaude:armor policy viewShow the active policy as raw JSON
/armorclaude:armor policy exportExport full policy state (version history included)

Adding Rules

/armorclaude:armor policy add allow Read
/armorclaude:armor policy add deny WebFetch
/armorclaude:armor policy add hold Bash
/armorclaude:armor policy add allow Read and Grep, deny Write, hold Bash

Effects: allow, deny (or block), hold (or require_approval, ask before).

Separate simple tool rules with commas and confirm a staged proposal with /armorclaude:armor yes. Complex conditions can produce a draft instead. Stage its ID with /armorclaude:armor policy stage <draft-id>, then confirm. Use canonical tool names; unsupported labels may be rejected.

Removing Rules

/armorclaude:armor policy remove policy1

Removes a specific rule by ID. Check IDs with /armorclaude:armor policy list.

Resetting Policy

/armorclaude:armor policy reset

Proposes removing all statements and setting the default to deny. This is not the permissive policy used on a fresh install. Confirm it, or use the all-allow template to restore permissive local policy.

Setting Default Decision

/armorclaude:armor policy default allow
/armorclaude:armor policy default deny
/armorclaude:armor policy default hold

Controls what happens when no rule matches a tool call.

Applying Templates

/armorclaude:armor policy template balanced

Templates include all-allow, strict-read-only, balanced, lockdown, architect, quality-guardian, velocity-machine, and night-owl. The four baseline templates are:

NameDescription
all-allowCaptures intent without blocking missing plans, drift, expiry, or proof failures
strict-read-onlyOnly Read/Grep/Glob allowed
balancedRead allowed, Bash/Write/Edit require approval
lockdownAll tools require approval

Crypto Binding

/armorclaude:armor policy rebind

Reissues the Merkle tree crypto binding for the current policy. Required only when the binding gets out of sync (rare).

Stage and Confirm

Every policy change goes through a two-step process:

/armorclaude:armor policy add deny Bash       # stages the change
/armorclaude:armor yes                        # applies it
CommandDescription
/armorclaude:armor yesApply the current staged proposal
/armorclaude:armor noDiscard the current staged proposal
/armorclaude:armor policy confirmApply (same as /armorclaude:armor yes)
/armorclaude:armor policy confirm pol_abc12345Apply a specific proposal by ID
/armorclaude:armor policy cancelDiscard (same as /armorclaude:armor no)
/armorclaude:armor policy cancel pol_abc12345Discard a specific proposal by ID

Staged proposals expire after 30 minutes. Local confirmation can stage a backend proposal; confirm it in dashboard Policies so a new connected session pulls the intended policy.

Draft Workflow

For complex policy changes, work with drafts before you stage them:

CommandDescription
/armorclaude:armor policy draft validate <json>Validate pasted policy JSON, create a draft
/armorclaude:armor policy draft edit <draft-id> <json>Replace a draft's JSON
/armorclaude:armor policy revise <draft-id> "<instruction>"Apply a deterministic edit to a draft
/armorclaude:armor policy stage <draft-id>Stage a draft for confirmation
/armorclaude:armor policy stage <json>Stage raw JSON directly

Example: Draft → Stage → Confirm

/armorclaude:armor policy draft validate {"schemaVersion":"armor.policy.v1","kind":"PolicyProfile","metadata":{"name":"custom"},"defaults":{"decision":"deny","conflictResolution":"deny_overrides"},"statements":[{"id":"s1","effect":"permit","principal":{"type":"agent","id":"claude-code"},"action":{"type":"tool","eq":"Read"},"resource":{"type":"workspace","scope":"current"},"conditions":[]}]}

Response: draft_abc12345 created.

/armorclaude:armor policy stage draft_abc12345
/armorclaude:armor yes

MCP Server Management

Control which MCP servers are trusted:

CommandDescription
/armorclaude:armor mcp listShow all detected MCP servers and their status
/armorclaude:armor mcp approve <server>Persistently approve an MCP server
/armorclaude:armor mcp deny <server>Persistently deny an MCP server

By default, ArmorClaude denies unknown MCP servers (mcpDenyByDefault: true). When an unknown server's tool is called, ArmorClaude uses Claude Code's native approval UI for a one-time allow. Use /armorclaude:armor mcp approve to trust a server permanently.

Profile Management

Save, switch, and share policy profiles:

CommandDescription
/armorclaude:armor profile listShow all saved profiles
/armorclaude:armor profile save <name>Save current policy as a named profile
/armorclaude:armor profile switch <name>Stage switching to a saved profile (requires confirm)
/armorclaude:armor profile delete <name>Delete a saved profile
/armorclaude:armor profile push <name>Stage a backend profile proposal. Confirm it in dashboard Policies
/armorclaude:armor profile pullPull confirmed organization profiles while signed in

Example: Save and Switch Profiles

/armorclaude:armor policy template balanced
/armorclaude:armor yes
/armorclaude:armor profile save my-balanced

/armorclaude:armor policy template lockdown
/armorclaude:armor yes
/armorclaude:armor profile save my-lockdown

/armorclaude:armor profile switch my-balanced
/armorclaude:armor yes

Settings

CommandDescription
/armorclaude:armor settingsShow current enforcement engine and settings
/armorclaude:armor settings enforcement localShow instructions to select local evaluation and restart
/armorclaude:armor settings enforcement opaShow environment and restart instructions for OPA

These commands do not switch the running engine. Set ARMORCLAUDE_ENFORCEMENT_ENGINE and, for OPA, ARMORCLAUDE_OPA_PDP_URL, then restart Claude Code.

Backend Sync

CommandDescription
/armorclaude:armor policy syncStage the current policy in the backend. Confirm it in dashboard Policies

Complete Command List

/armorclaude:armor                                - show help
/armorclaude:armor policy list                    - show current rules
/armorclaude:armor policy view                    - show active policy JSON
/armorclaude:armor policy export                  - export full policy state
/armorclaude:armor policy default <allow|deny|hold> - set default decision
/armorclaude:armor policy add <rules>             - stage new rules
/armorclaude:armor policy remove <rule-id>        - propose removing a rule
/armorclaude:armor policy reset                   - propose clearing all rules
/armorclaude:armor policy template <name>         - propose applying a template
/armorclaude:armor policy rebind                  - reissue crypto binding
/armorclaude:armor policy draft validate <json>   - validate and create a draft
/armorclaude:armor policy draft edit <id> <json>  - replace a draft's JSON
/armorclaude:armor policy revise <id> "<instr>"   - edit a draft deterministically
/armorclaude:armor policy stage <id|json>         - stage a draft or JSON
/armorclaude:armor policy confirm [proposal-id]   - apply staged change
/armorclaude:armor policy cancel [proposal-id]    - discard staged change
/armorclaude:armor yes                            - apply current staged change
/armorclaude:armor no                             - discard current staged change
/armorclaude:armor mcp list                       - show detected MCP servers
/armorclaude:armor mcp approve <server>           - approve an MCP server
/armorclaude:armor mcp deny <server>              - deny an MCP server
/armorclaude:armor profile list                   - show saved profiles
/armorclaude:armor profile save <name>            - save current policy as profile
/armorclaude:armor profile switch <name>          - switch to a saved profile
/armorclaude:armor profile delete <name>          - delete a profile
/armorclaude:armor profile push <name>            - push profile to backend
/armorclaude:armor profile pull                   - pull org profiles from backend
/armorclaude:armor settings                       - show settings
/armorclaude:armor settings enforcement <engine>  - show engine environment and restart instructions
/armorclaude:armor sync                           - stage a backend policy proposal

On this page