.env.example

# Graft — configuration
#
# Graft calls an LLM for concept nodes + per-symbol summaries, so an API key is
# required for the deep pass (`build --deep`). The structural build (`build`,
# `check`, `ask`, `grep`, `map`, traversal) is deterministic tree-sitter and
# needs no key.
#
# Graft is vendor-neutral: GRAFT_PROVIDER picks the WIRE FORMAT, not a company.
# Bring your own key from whichever provider you use.

# --- Provider (required for `build --deep`) -----------------------------------
# Wire format / SDK: "openai" (any OpenAI-compatible endpoint), "anthropic",
# "litellm" (a LiteLLM proxy), or "orcarouter" (the OrcaRouter AI gateway).
# GRAFT_PROVIDER=openai
# Your provider API key.
# GRAFT_API_KEY=
# Model id, as your provider names it.
# GRAFT_MODEL=openai/gpt-4o-mini
# Base URL for the "openai" wire format — this is how you pick a provider.
# Leave unset to hit api.openai.com. Examples:
#   OpenRouter:  https://openrouter.ai/api/v1
#   Fireworks:   https://api.fireworks.ai/inference/v1
#   Groq:        https://api.groq.com/openai/v1
#   LiteLLM:     http://localhost:4000   (your proxy)
#   Ollama:      http://localhost:11434/v1
# GRAFT_BASE_URL=https://openrouter.ai/api/v1
#
# Native Anthropic (no base URL needed):
#   GRAFT_PROVIDER=anthropic
#   GRAFT_API_KEY=sk-ant-...
#   GRAFT_MODEL=claude-sonnet-5
#
# OrcaRouter AI gateway (OpenAI-compatible, no base URL needed):
#   GRAFT_PROVIDER=orcarouter
#   GRAFT_API_KEY=sk-orca-...
#   GRAFT_MODEL=openai/gpt-4o-mini

# --- Deprecated (still honored as a fallback) ---------------------------------
# If GRAFT_API_KEY is unset, these legacy OpenRouter vars are used instead.
# OPENROUTER_API_KEY=sk-or-...
# OPENROUTER_BASE_URL=https://openrouter.ai/api/v1
# GRAFT_OPENROUTER_MODEL=openai/gpt-4o-mini
#
# If GRAFT_API_KEY and the OpenRouter fallback are both unset, OrcaRouter's
# vars are honored as a second fallback.
# ORCAROUTER_API_KEY=sk-orca-...
# ORCAROUTER_BASE_URL=https://api.orcarouter.ai/v1
# ORCAROUTER_MODEL=openai/gpt-4o-mini

# --- Graph location -----------------------------------------------------------
# Where the graph lives (default: <repo>/.context)
# GRAFT_DIR=.context

# --- Build side effects (opt-out) ---------------------------------------------
# GRAFT_NO_GITIGNORE=1  — skip writing graft/ into .gitignore (e.g. you already ignore it globally)
# GRAFT_NO_IGNORE=1     — skip writing .ignore (ripgrep re-admit); only if you manage search yourself

# --- Init (Claude Code) -------------------------------------------------------
# Skip writing statusLine / subagentStatusLine during `graft init` (same as
# `--no-statusline`). Use this when you already have a custom Claude Code
# statusline — a project-level field would hide one in ~/.claude/settings.json.
# GRAFT_NO_STATUSLINE=1

# --- Benchmark (bench/) -------------------------------------------------------
# Per-role model overrides for the benchmark harness.
# BENCH_AGENT_MODEL=anthropic/claude-sonnet-5
# BENCH_JUDGE_MODEL=anthropic/claude-opus-4.8