Getting Started

Policy Profiles

Save and switch named policy configurations

Policy Profiles

Profiles let you save a policy configuration and switch between them. This is handy for keeping, say, a balanced policy for day-to-day work and a lockdown policy for sensitive tasks.

Saving a Profile

Save the current active policy as a named profile:

armor profile save strict-mode

The profile captures the current rules. Saving applies immediately (it does not change active enforcement).

Listing Profiles

armor profile list

Shows all saved profiles with their rule count:

Saved profiles:
  - strict-mode (4 rules)
  - balanced (2 rules)

Switching Profiles

Switch to a saved profile. This stages the change for confirmation, so activating a profile still goes through the stage then confirm flow:

armor profile switch balanced
armor yes

The switch replaces your entire active policy with the profile's policy.

Deleting Profiles

armor profile delete strict-mode

Deletes immediately, no confirmation needed.

Workflow Example

Keep a balanced everyday policy and a lockdown policy, and swap between them:

armor policy template balanced
armor yes
armor profile save everyday

armor policy template lockdown
armor yes
armor profile save sensitive

armor profile switch everyday
armor yes

Profiles are local to your machine today. Sharing profiles across an organization (push and pull to the ArmorIQ backend) is not yet available in ArmorCodex; it is tracked as a parity gap with backend policy sync.

Where Profiles are Stored

Profiles are saved alongside your policy in the ArmorCodex data directory:

cat ~/.codex/armorcodex/policy-profiles.json

On this page