CLI
ArmorIQ CLI
The armoriq command-line tool
ArmorIQ CLI
The armoriq CLI ships with the Python SDK (pip install armoriq-sdk). It
handles auth, project setup, and control-plane registration so you don't have
to write any of that by hand.
Commands
| Command | What it does |
|---|---|
armoriq init | Interactive setup — generates armoriq.yaml |
armoriq login | Browser-based OAuth device-code login |
armoriq logout | Remove saved credentials |
armoriq whoami | Show current authentication status |
armoriq validate | Verify config, API key, and MCP connectivity |
armoriq register | Push config to the ArmorIQ control plane |
armoriq status | Show what's currently registered and active |
armoriq logs | Stream activity logs in the terminal |
armoriq orgs | List organizations your account belongs to |
armoriq switch-org | Switch to a different org (mints a new scoped API key) |
Typical first-time flow
# 1. Install
pip install armoriq-sdk
# 2. Authenticate (opens a browser)
armoriq login
# 3. Scaffold a project
armoriq init
# 4. Verify config + API key + MCPs
armoriq validate
# 5. Push to ArmorIQ control plane
armoriq registerThat leaves you with an armoriq.yaml in your project and credentials in
~/.armoriq/.
State and logs
The CLI keeps local state under ~/.armoriq/:
state.json— registered config, org context, login sessioncli.log— append-only audit log of CLI actions