ArmorIQ LogoArmorIQ SDK
CLI

armoriq init

Interactive setup — generate an armoriq.yaml

armoriq init

Interactive wizard that walks you through identity, proxy, MCP servers, and policy defaults, and writes an armoriq.yaml you can check into your repo.

Usage

armoriq init
armoriq init --output myproject.yaml    # custom path

Flags

FlagDefaultDescription
--outputarmoriq.yamlPath for the generated config file

What it prompts for

  • Identity — org, project name
  • Proxy — the ArmorIQ proxy endpoint (defaults to production)
  • MCP servers — one or more tool providers with URL + auth
  • Policy defaults — allow / deny / hold rules

It will not overwrite an existing file without confirmation.

Example output

# armoriq.yaml (generated)
identity:
  org: acme
  project: q4-sales-bot

proxy:
  url: https://proxy.armoriq.ai

mcp_servers:
  - id: data-mcp
    url: https://data.internal/mcp
    auth:
      type: bearer
      token_env: DATA_MCP_TOKEN

policy:
  default: allow
  rules:
    - match: { mcp: data-mcp, action: delete_all }
      decision: block

Next steps

armoriq validate    # check it works
armoriq register    # push to control plane

Or load the config directly from Python:

from armoriq_sdk import ArmorIQClient
client = ArmorIQClient.from_config("armoriq.yaml")

On this page