CLI environment

Configure credentials, destinations, diagnostics, and operator settings outside project content configuration.

Environment variables supply machine-specific settings. Keep source paths, target locales, and output layout in .lingo/config.json, where the project can share them. Keep secrets in the runtime or runner's secret store.

Credentials and destinations #

VariableBehavior
LINGO_API_KEYCredential below an invocation --api-key and above stored login.
LINGO_API_URLAPI base; default https://api.lingo.dev.

An alternate destination receives the caller's content and credentials. Use only a trusted, authorized service.

Diagnostics and opt-outs #

VariableBehavior
LINGO_DEBUGAny nonempty value enables startup diagnostics.
LINGO_TELEMETRY_DISABLED=1 or DO_NOT_TRACK=1Disable CLI telemetry: usage events and OTLP export.
NO_UPDATE_NOTIFIER=1 or LINGO_DISABLE_UPDATE_CHECK=1Disable automatic update checks.
NO_COLORAffects color presentation.
CIAffects presentation; detected CI also skips update checks.

Use the exact 1 opt-out values. Debug diagnostics include Node version, platform, cwd, and raw argv. A command-line API key can appear there. Remove secrets before sharing diagnostics, and do not treat disabled debug as protection from all process or failure inspection.

Local scoring #

lingo score requires OPENROUTER_API_KEY, independently of Lingo login. Its model configuration's provider field contributes to an OpenRouter model slug rather than choosing a transport.

Operator log-export overrides #

Log export recognizes LINGO_SIGNOZ_INGEST_ENDPOINT, OTEL_EXPORTER_OTLP_LOGS_ENDPOINT, and OTEL_EXPORTER_OTLP_ENDPOINT, in that precedence order. Ingestion-key selection prefers LINGO_SIGNOZ_INGEST_KEY over SIGNOZ_INGESTION_KEY; OTEL_EXPORTER_OTLP_HEADERS can supply additional headers. OTEL_SERVICE_NAME defaults to @lingo.dev/cli.

These configure diagnostics infrastructure, not translation. Keep keys and secret headers outside repository files and support logs. Authentication explains ordinary identity selection; Configuration owns project paths and locales.