Install

Install AVC globally via npm:

npm install -g @agile-vibe-coding/avc

Then launch it:

avc

Type / and press Enter to open the command selector, or type a command name directly.

---

API Keys Required

AVC uses LLM providers to power ceremonies and generate project documentation.

Setting Up API Keys

When you run /init, AVC creates a .env file in your project directory with placeholders:

ANTHROPIC_API_KEY=
GEMINI_API_KEY=

Steps:

1. Run /init to initialize the project.
2. Open the .env file in your project directory
3. Add your API key(s) for the provider(s) you want to use
4. Save the file
5. Run /sponsor-call to define your project with AI assistance

Example:

ANTHROPIC_API_KEY=sk-ant-api03-your-key-here
GEMINI_API_KEY=AIzaSy-your-gemini-key-here

Note: You only need to configure keys for the providers you're actually using. Check your .avc/avc.json file to see which provider is configured for your ceremonies.

Configuring Providers Per Ceremony

Each ceremony in .avc/avc.json can use a different provider:

{
  "settings": {
    "ceremonies": [
      {
        "name": "sponsor-call",
        "provider": "claude",
        "defaultModel": "claude-sonnet-4-5-20250929"
      }
    ]
  }
}

Supported Providers

AVC currently supports the following LLM providers:

Provider	Models	API Key Variable	Get API Key
Claude (Anthropic)	claude-sonnet-4-5-20250929 claude-opus-4-5-20251101	ANTHROPIC_API_KEY	console.anthropic.com
Gemini (Google)	gemini-2.5-flash gemini-2.5-pro	GEMINI_API_KEY	aistudio.google.com