Skip to content

Environment variables

Environment variables override verlato.json; command-line options override both. The VS Code extension sets many of these from its settings (shown in the last column).

Files and evidence

Variable Meaning VS Code setting
VERLATO_CONFIG_PATH config file to use instead of ./verlato.json
VERLATO_STATE_PATH state file (default .verlato_state.json)
VERLATO_DIFF_ENGINE intentumdiff or git verlato.diffEngine
VERLATO_INTENTUMDIFF_WASM_DIR (or INTENTUMDIFF_WASM_DIR) the IntentumDiff parser bundle directory
VERLATO_SEMANTIC_CACHE_PATH semantic review cache (default .verlato_semantic_cache.json)
VERLATO_SEMANTIC_PARALLELISM threads for uncached commit reviews (default up to 4, at most 16) verlato.semanticParallelism
VERLATO_SEMANTIC_CROSS_FILE 1/true turns cross-file move/rename detection on, 0 off (overrides semantic_cross_file) verlato.semanticCrossFile
VERLATO_SEMANTIC_MAX_NODES raised engine size limit in tree nodes (overrides semantic_max_nodes)
VERLATO_PR_ADAPTER standard-git (default), github or none (PR mapping)
VERLATO_GITHUB_REPO owner/repo for the github PR adapter
GITHUB_TOKEN or GH_TOKEN token for the github PR adapter and the GitHub Models provider
VERLATO_GITHUB_API_URL GitHub REST API base URL (default https://api.github.com)
VERLATO_COMMIT_INTENT_INFERENCE off or low-signal verlato.commitIntentInference
VERLATO_FEEDBACK_INCLUDE_TEXT 1 keeps summary text in feedback events verlato.feedbackIncludeText
VERLATO_SUMMARY_STYLE prose (default) or evidence: how model-free summaries are written (summary_style)

Models

Variable Meaning VS Code setting
VERLATO_MODEL_PROVIDER provider name verlato.modelProvider
VERLATO_MODEL_PRIVACY privacy mode verlato.modelPrivacy
VERLATO_ALLOW_REMOTE_PATCHES 1 selects trusted-provider-patch for scans and drafts verlato.allowRemotePatches
VERLATO_MODEL_MAX_ITEMS fanout guard: skip model calls above this many changesets (default 25, -1 off) verlato.maxModelItems
VERLATO_OLLAMA_MODEL, VERLATO_OLLAMA_SUGGEST_MODEL Ollama model, and a suggestion-only model verlato.ollamaModel, verlato.ollamaSuggestionModel
VERLATO_OLLAMA_ENDPOINT Ollama chat endpoint verlato.ollamaEndpoint
VERLATO_OLLAMA_TIMEOUT_SECONDS per-request timeout (default 15) verlato.ollamaTimeoutSeconds
VERLATO_OLLAMA_STREAM 1 streams responses into telemetry verlato.ollamaStreamResponses
VERLATO_OLLAMA_KEEP_ALIVE keep the model loaded (default 10m; empty for Ollama's default)
VERLATO_OLLAMA_NUM_CTX context window
VERLATO_OLLAMA_NUM_PREDICT global output cap
VERLATO_OLLAMA_SUMMARY_NUM_PREDICT, VERLATO_OLLAMA_CLASSIFY_NUM_PREDICT, VERLATO_OLLAMA_SUGGEST_NUM_PREDICT per-task output caps (180, 24, adaptive)
VERLATO_OLLAMA_SUGGEST_THINK 1 allows thinking on suggestion requests
VERLATO_LITELLM_ENDPOINT, VERLATO_LITELLM_MODEL, VERLATO_LITELLM_SUGGEST_MODEL LiteLLM / OpenAI-compatible endpoint and models
VERLATO_LITELLM_API_KEY, VERLATO_LITELLM_API_KEY_ENV the API key, or the name of the variable holding it
VERLATO_LITELLM_TIMEOUT_SECONDS, VERLATO_LITELLM_MAX_TOKENS timeout (default 30) and max_tokens (default 1024, 0 none)
VERLATO_PLUGIN_COMMAND, VERLATO_PLUGIN_MODEL, VERLATO_PLUGIN_SUGGEST_MODEL plugin command (shell-style) and models
VERLATO_PLUGIN_ENV, VERLATO_PLUGIN_TIMEOUT_SECONDS comma-separated variables passed to the plugin; timeout (default 30)
VERLATO_GITHUB_MODEL, VERLATO_GITHUB_MODELS_ENDPOINT GitHub Models model (default openai/gpt-4o-mini) and endpoint
VERLATO_CODEX_COMMAND, VERLATO_CODEX_MODEL, VERLATO_CODEX_TIMEOUT_SECONDS the Codex CLI (default timeout 120)
VERLATO_CLAUDE_COMMAND, VERLATO_CLAUDE_MODEL, VERLATO_CLAUDE_TIMEOUT_SECONDS the Claude Code CLI (default timeout 120)

Suggestions and style

Variable Meaning VS Code setting
VERLATO_SUGGESTION_STRATEGY auto, single, paired, full-diff-json, tool-retrieval verlato.suggestionStrategy
VERLATO_SUGGESTION_COUNT suggestions per item (1-5) verlato.suggestionCount
VERLATO_SUGGESTION_PARALLELISM items at once (1-8) verlato.suggestionParallelism
VERLATO_SUGGESTION_BATCH_SIZE items per structured request (1-5) verlato.suggestionBatchSize
VERLATO_SUGGESTION_PROMPT_PROFILE conservative, lean, minimal verlato.suggestionPromptProfile
VERLATO_SUGGESTION_ADAPTIVE_RECOMMENDATIONS 1 adds tuning advice verlato.suggestionAdaptiveRecommendations
VERLATO_SUGGESTION_TONE release-note, concise, technical, customer-facing verlato.suggestionTone
VERLATO_SUGGESTION_CACHE_BACKEND json (the only backend)
VERLATO_SUGGESTION_CACHE_PATH suggestion cache file
VERLATO_SUGGESTION_CACHE_TTL_DAYS cache expiry in days (default 30)
VERLATO_STYLE_GUIDANCE project writing guidance verlato.styleGuidance
VERLATO_PROJECT_VOCABULARY, VERLATO_BANNED_PHRASES comma-separated lists verlato.projectVocabulary, verlato.bannedPhrases
VERLATO_SPECIFICITY_FLOOR 0-1; reject vaguer suggestions verlato.specificityFloor

Diagnostics

Variable Meaning VS Code setting
VERLATO_TRACE_PROGRESS 1 prints [verlato:progress] events on stderr (always on)
VERLATO_TRACE_MODEL_CALLS 1 prints [verlato:model] model lifecycle events (always on)
VERLATO_TRACE_MODEL_PAYLOADS 1 includes full prompts and responses verlato.telemetry.includePromptPayloads
VERLATO_TRACE_MODEL_REASONING 1 includes provider-exposed reasoning text verlato.telemetry.includeReasoningPayloads
VERLATO_REDACT_MODEL_PAYLOADS 0 turns payload redaction off (on by default) verlato.telemetry.redactPayloads
VERLATO_MODEL_LOG_PATH append JSONL model telemetry to this file verlato.telemetry.debugModelLogPath

The extension always sets VERLATO_SEMANTIC_CROSS_FILE from verlato.semanticCrossFile, so in VS Code that setting decides, not semantic_cross_file in verlato.json.