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 #
| Variable | Behavior |
|---|---|
LINGO_API_KEY | Credential below an invocation --api-key and above stored login. |
LINGO_API_URL | API 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 #
| Variable | Behavior |
|---|---|
LINGO_DEBUG | Any nonempty value enables startup diagnostics. |
LINGO_TELEMETRY_DISABLED=1 or DO_NOT_TRACK=1 | Disable CLI telemetry: usage events and OTLP export. |
NO_UPDATE_NOTIFIER=1 or LINGO_DISABLE_UPDATE_CHECK=1 | Disable automatic update checks. |
NO_COLOR | Affects color presentation. |
CI | Affects 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.