Configuration Reference

Complete reference for all AIV configuration options.

Configuration Files

File	Location	Purpose
config.json	~/.aiv/	Provider and workspace settings
.env	~/.aiv/	API keys and secrets
.mcp.json	Project root	MCP server configuration

config.json

{
  "defaultProvider": "anthropic",
  "anthropic": {
    "model": "claude-sonnet-4-20250514"
  },
  "azure": {
    "endpoint": "https://resource.openai.azure.com",
    "deployment": "gpt-4o",
    "apiVersion": "2024-02-15-preview"
  },
  "openrouter": {
    "model": "anthropic/claude-sonnet-4",
    "budgetLimit": 10.00
  },
  "workspace": "/path/to/workspace"
}

Environment Variables

# Anthropic
ANTHROPIC_API_KEY=sk-ant-...

# Azure OpenAI
AZURE_OPENAI_ENDPOINT=https://resource.openai.azure.com
AZURE_OPENAI_KEY=...

# OpenRouter
OPENROUTER_API_KEY=sk-or-...

# Optional
LOG_LEVEL=info
DEBUG=false

MCP Configuration

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@context7/mcp-server"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    }
  },
  "_disabled": {
    "disabled-server": {
      "command": "npx",
      "args": ["-y", "@disabled/server"]
    }
  }
}

Provider Switching

# Switch provider at runtime
aiv
> /model azure

# Or via config
aiv --provider anthropic

See Quick Start for usage examples.