Skip to content

Configuration

Interactive Setup

The easiest way to configure iam-zero:

iam-zero configure

This prompts you for:

  1. Anthropic API Key — get one from console.anthropic.com
  2. GitHub Token (optional) — classic PAT with repo scope from GitHub Settings
  3. Default AWS Profile (optional) — your AWS profile name
  4. Default GCP Project (optional) — your GCP project ID

Configuration File

Settings are stored in ~/.iam-zero/config.toml:

[anthropic]
api_key = "sk-ant-..."

[github]
token = "ghp_..."
repo = "your-org/your-infra"

[aws]
profile = "default"

[gcp]
project = "my-project"

Environment Variables

You can also use environment variables:

Variable Description
ANTHROPIC_API_KEY Anthropic API key
GITHUB_TOKEN GitHub PAT
AWS_PROFILE AWS profile name
GCP_PROJECT Default GCP project

Environment variables take precedence over config file values.