home

Configuration

Setup and customize chronicle.

Quick Setup

chronicle config init

Interactive wizard to configure provider, model, and API key.

Providers

  • openai OpenAI
  • anthropic Anthropic
  • gemini Google Gemini
  • openrouter OpenRouter
  • ollama Ollama (Local, no API key)
  • cloudflare Cloudflare AI Gateway (Account ID, Gateway ID, API token)
  • opencode-zen OpenCode Zen
  • groq Groq

Environment Variables

# Standard hosted providers
export CHRONICLE_AI_KEY=your-api-key

# Cloudflare AI Gateway
export CF_ACCOUNT_ID=your-account-id
export CF_GATEWAY_ID=your-gateway-id
export CF_API_TOKEN=your-api-token

Ollama only needs a base URL. You can also enter credentials during config init. Config is stored at ~/.config/chronicle/config.json.

Stored Fields

Field Description
llm.selected.provider Currently active provider
llm.selected.model Currently active model
llm.providers[] Saved provider credentials and provider-specific settings
llm.customPrompt Optional custom instructions for AI output
git.authorName / git.authorEmail Stored git identity fallback
defaults.* Backfill defaults like timeline and work hours

Config Shape

{
  "llm": {
    "selected": {
      "provider": "anthropic",
      "model": "claude-sonnet-4-20250514"
    },
    "providers": [
      {
        "name": "anthropic",
        "API_TOKEN": "***",
        "model": "claude-sonnet-4-20250514"
      },
      {
        "name": "ollama",
        "baseUrl": "http://localhost:11434",
        "model": "llama3.2"
      }
    ]
  }
}

Examples

# Run full setup
chronicle config init

# Switch providers without overwriting saved credentials
chronicle config provider

# Change the model for the selected provider
chronicle config model

# Show current config
chronicle config show