Environment variables

OpenCode v1.18.34 reads 131 environment variables by name: 67 of its own and 64 that providers, the host or other tools define. Each was found where the code reads it (process.env, Bun.env, OpenCode's Flag helpers or Effect Config), and the reading code says what value it expects. Topics group them by what they control; whether one is set depends on the user's environment.

return process.env[key] === undefined ? truthy("OPENCODE_EXPERIMENTAL") : truthy(key)
enableExa: truthy("OPENCODE_EXPERIMENTAL") || truthy("OPENCODE_ENABLE_EXA") || truthy("OPENCODE_EXPERIMENTAL_EXA"),

experimentalBackgroundSubagents: enabledByExperimental("OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS"),

experimentalCodeMode: enabledByExperimental("OPENCODE_EXPERIMENTAL_CODE_MODE"),

const copy = process.env["OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT"]
copy === undefined ? process.platform === "win32" : truthy("OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT"),

OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER: Config.boolean("OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER").pipe(

experimentalEventSystem: enabledByExperimental("OPENCODE_EXPERIMENTAL_EVENT_SYSTEM"),

enableExa: truthy("OPENCODE_EXPERIMENTAL") || truthy("OPENCODE_ENABLE_EXA") || truthy("OPENCODE_EXPERIMENTAL_EXA"),

OPENCODE_EXPERIMENTAL_FILEWATCHER: Config.boolean("OPENCODE_EXPERIMENTAL_FILEWATCHER").pipe(

experimentalIconDiscovery: enabledByExperimental("OPENCODE_EXPERIMENTAL_ICON_DISCOVERY"),

experimentalLspTool: enabledByExperimental("OPENCODE_EXPERIMENTAL_LSP_TOOL"),

experimentalOxfmt: enabledByExperimental("OPENCODE_EXPERIMENTAL_OXFMT"),

enableParallel: truthy("OPENCODE_ENABLE_PARALLEL") || truthy("OPENCODE_EXPERIMENTAL_PARALLEL"),

experimentalPlanMode: enabledByExperimental("OPENCODE_EXPERIMENTAL_PLAN_MODE"),

return enabledByExperimental("OPENCODE_EXPERIMENTAL_REFERENCES")
experimentalReferences: enabledByExperimental("OPENCODE_EXPERIMENTAL_REFERENCES"),

OPENCODE_EXPERIMENTAL_WORKSPACES: enabledByExperimental("OPENCODE_EXPERIMENTAL_WORKSPACES"),
experimentalWorkspaces: enabledByExperimental("OPENCODE_EXPERIMENTAL_WORKSPACES"),

? { deploymentId: process.env.AICORE_DEPLOYMENT_ID, resourceGroup: process.env.AICORE_RESOURCE_GROUP }
const deploymentId = process.env.AICORE_DEPLOYMENT_ID

? { deploymentId: process.env.AICORE_DEPLOYMENT_ID, resourceGroup: process.env.AICORE_RESOURCE_GROUP }
const resourceGroup = process.env.AICORE_RESOURCE_GROUP

process.env.AICORE_SERVICE_KEY ??
if (serviceKey && !process.env.AICORE_SERVICE_KEY) process.env.AICORE_SERVICE_KEY = serviceKey
const envAICoreServiceKey = process.env.AICORE_SERVICE_KEY

process.env.AWS_BEARER_TOKEN_BEDROCK ??
if (bearerToken && !process.env.AWS_BEARER_TOKEN_BEDROCK) process.env.AWS_BEARER_TOKEN_BEDROCK = bearerToken
const envToken = process.env.AWS_BEARER_TOKEN_BEDROCK

process.env.AWS_CONTAINER_CREDENTIALS_RELATIVE_URI || process.env.AWS_CONTAINER_CREDENTIALS_FULL_URI,

process.env.AWS_CONTAINER_CREDENTIALS_RELATIVE_URI || process.env.AWS_CONTAINER_CREDENTIALS_FULL_URI,

const profile = typeof options.profile === "string" ? options.profile : process.env.AWS_PROFILE

const region = typeof options.region === "string" ? options.region : (process.env.AWS_REGION ?? "us-east-1")
const region = typeof evt.options.region === "string" ? evt.options.region : process.env.AWS_REGION

const resourceName = process.env.AZURE_COGNITIVE_SERVICES_RESOURCE_NAME

typeof configured === "string" && configured.trim() !== "" ? configured : process.env.AZURE_RESOURCE_NAME
if (!process.env.AZURE_RESOURCE_NAME) {
const resourceName = inputs?.resourceName ?? process.env.AZURE_RESOURCE_NAME

const apiKey = process.env.CLOUDFLARE_API_TOKEN ?? process.env.CF_AIG_TOKEN ?? stringOption(options, "apiKey")

const accountId = process.env.CLOUDFLARE_ACCOUNT_ID ?? stringOption(options, "accountId")
return process.env.CLOUDFLARE_ACCOUNT_ID ?? stringOption(options, "accountId")
return baseURL.replaceAll("${CLOUDFLARE_ACCOUNT_ID}", process.env.CLOUDFLARE_ACCOUNT_ID ?? "${CLOUDFLARE_ACCOUNT_ID}")

apiKey: process.env.CLOUDFLARE_API_KEY ?? options.apiKey,

const apiKey = process.env.CLOUDFLARE_API_TOKEN ?? process.env.CF_AIG_TOKEN ?? stringOption(options, "apiKey")

process.env.CLOUDFLARE_GATEWAY_ID ?? stringOption(options, "gatewayId") ?? stringOption(options, "gateway")
...(!process.env.CLOUDFLARE_GATEWAY_ID

exaApiKey: process.env.EXA_API_KEY,
export const EXA_URL = process.env.EXA_API_KEY
? `https://mcp.exa.ai/mcp?exaApiKey=${encodeURIComponent(process.env.EXA_API_KEY)}`

process.env.GCLOUD_PROJECT
: (process.env.GOOGLE_CLOUD_PROJECT ?? process.env.GCP_PROJECT ?? process.env.GCLOUD_PROJECT)

process.env.GCP_PROJECT ??
: (process.env.GOOGLE_CLOUD_PROJECT ?? process.env.GCP_PROJECT ?? process.env.GCLOUD_PROJECT)

: (process.env.GITLAB_INSTANCE_URL ?? "https://gitlab.com"),

apiKey: typeof evt.options.apiKey === "string" ? evt.options.apiKey : process.env.GITLAB_TOKEN,

process.env.GOOGLE_CLOUD_LOCATION ??
: (process.env.GOOGLE_CLOUD_LOCATION ?? process.env.VERTEX_LOCATION ?? "global")

process.env.GOOGLE_CLOUD_PROJECT ??
: (process.env.GOOGLE_CLOUD_PROJECT ?? process.env.GCP_PROJECT ?? process.env.GCLOUD_PROJECT)

process.env.GOOGLE_VERTEX_LOCATION ??

process.env.GOOGLE_VERTEX_PROJECT ??

const apiKey = ctx.auth?.type === "api" ? ctx.auth.key : process.env.MODAL_PROXY_TOKEN

const hasKey = Boolean(process.env.OPENCODE_API_KEY || connected || item.provider.request.body.apiKey)

if (process.env.OPENCODE_AUTH_CONTENT) {
return JSON.parse(process.env.OPENCODE_AUTH_CONTENT)

process.env["OPENCODE_CONSOLE_TOKEN"] = tokenOpt.value

enableExa: truthy("OPENCODE_EXPERIMENTAL") || truthy("OPENCODE_ENABLE_EXA") || truthy("OPENCODE_EXPERIMENTAL_EXA"),

enableParallel: truthy("OPENCODE_ENABLE_PARALLEL") || truthy("OPENCODE_EXPERIMENTAL_PARALLEL"),

process.env.OPENCODE_WEBSEARCH_PROVIDER === "exa" || process.env.OPENCODE_WEBSEARCH_PROVIDER === "parallel"
? process.env.OPENCODE_WEBSEARCH_PROVIDER
const override = process.env.OPENCODE_WEBSEARCH_PROVIDER

parallelApiKey: process.env.PARALLEL_API_KEY,
if (!process.env.PARALLEL_API_KEY) return headers
return { ...headers, Authorization: `Bearer ${process.env.PARALLEL_API_KEY}` }

process.env.SNOWFLAKE_CORTEX_PAT ??

process.env.SNOWFLAKE_CORTEX_TOKEN ??

process.env.VERTEX_LOCATION ??
: (process.env.GOOGLE_CLOUD_LOCATION ?? process.env.VERTEX_LOCATION ?? "global")

OPENCODE_CONFIG: process.env["OPENCODE_CONFIG"],

OPENCODE_CONFIG_CONTENT: process.env["OPENCODE_CONFIG_CONTENT"],
if (process.env.OPENCODE_CONFIG_CONTENT) {
const next = yield* loadConfig(process.env.OPENCODE_CONFIG_CONTENT, {

return process.env["OPENCODE_CONFIG_DIR"]

OPENCODE_DB: process.env["OPENCODE_DB"],

process.env.OPENCODE_DISABLE_CHANNEL_DB === "1" ||
process.env.OPENCODE_DISABLE_CHANNEL_DB === "true"

OPENCODE_DISABLE_MODELS_FETCH: truthy("OPENCODE_DISABLE_MODELS_FETCH"),

return truthy("OPENCODE_DISABLE_PROJECT_CONFIG")

OPENCODE_MODELS_PATH: process.env["OPENCODE_MODELS_PATH"],

OPENCODE_MODELS_URL: process.env["OPENCODE_MODELS_URL"],

return process.env["OPENCODE_PERMISSION"]

return process.env["OPENCODE_PLUGIN_META_FILE"]

return truthy("OPENCODE_PURE")
process.env.OPENCODE_PURE = "1"

return process.env.OPENCODE_TEST_HOME ?? os.homedir()

return process.env.OPENCODE_TEST_MANAGED_CONFIG_DIR || systemManagedConfigDir()

return process.env["OPENCODE_TUI_CONFIG"]

process.env.OPENCODE_ZED_DB,

const xdgConfig = process.env.XDG_CONFIG_HOME || path.join(home, ".config")

process.env.AGENT = "1"

const value = process.env["GITHUB_RUN_ID"]

const githubToken = process.env["GITHUB_TOKEN"]

const mentions = (process.env["MENTIONS"] || "/opencode,/oc")

const value = process.env["MODEL"]

return process.env["OPENCODE_CALLER"] === "vscode" || process.env["OPENCODE_CALLER"] === "vscode-insiders"

return process.env["OPENCODE_CLIENT"] ?? "cli"
process.env.OPENCODE_CLIENT = "acp"
client: Config.string("OPENCODE_CLIENT").pipe(Config.withDefault("cli")),

const disabled = process.env["OPENCODE_DISABLE_SHARE"] === "true" || process.env["OPENCODE_DISABLE_SHARE"] === "1"

const base = process.env.OPENCODE_REPO_CLONE_GITHUB_BASE_URL

initialRoute: process.env.OPENCODE_ROUTE ? JSON.parse(process.env.OPENCODE_ROUTE) : undefined,

OPENCODE_SERVER_PASSWORD: process.env["OPENCODE_SERVER_PASSWORD"],
*     password: Config.string("OPENCODE_SERVER_PASSWORD").pipe(Config.option),
const password = credentials?.password ?? process.env.OPENCODE_SERVER_PASSWORD

OPENCODE_SERVER_USERNAME: process.env["OPENCODE_SERVER_USERNAME"],
*     username: Config.string("OPENCODE_SERVER_USERNAME").pipe(Config.withDefault("opencode")),
return `Basic ${Buffer.from(`${credentials?.username ?? process.env.OPENCODE_SERVER_USERNAME ?? "opencode"}:${password}`).toString("base64")}`

OPENCODE_WORKSPACE_ID: process.env["OPENCODE_WORKSPACE_ID"],

const customPrompt = process.env["PROMPT"]

const value = process.env["SHARE"]

const value = process.env["USE_GITHUB_TOKEN"]

const variant = process.env["VARIANT"] || undefined

OPENCODE_AUTO_HEAP_SNAPSHOT: truthy("OPENCODE_AUTO_HEAP_SNAPSHOT"),

if (!process.env.OPENCODE_DIRECT_TRACE) {

const value = process.env.OPENCODE_LOG_LEVEL?.toUpperCase()
if (opts.logLevel) process.env.OPENCODE_LOG_LEVEL = opts.logLevel

return process.env.OPENCODE_PRINT_LOGS === "1" ? [fileLogger(), stderrLogger] : [fileLogger()]
if (opts.printLogs) process.env.OPENCODE_PRINT_LOGS = "1"

OPENCODE_SHOW_TTFD: truthy("OPENCODE_SHOW_TTFD"),

OTEL_EXPORTER_OTLP_ENDPOINT: process.env["OTEL_EXPORTER_OTLP_ENDPOINT"],
OTEL_EXPORTER_OTLP_ENDPOINT: process.env.OTEL_EXPORTER_OTLP_ENDPOINT,

OTEL_EXPORTER_OTLP_HEADERS: process.env["OTEL_EXPORTER_OTLP_HEADERS"],
OTEL_EXPORTER_OTLP_HEADERS: process.env.OTEL_EXPORTER_OTLP_HEADERS,

const value = process.env.OTEL_RESOURCE_ATTRIBUTES
OTEL_RESOURCE_ATTRIBUTES: process.env.OTEL_RESOURCE_ATTRIBUTES,

const value = process.env.CLAUDE_CODE_SSE_PORT || process.env.OPENCODE_EDITOR_SSE_PORT

const enabled = process.env.OPENCODE_ACP_PROFILE === "1"

OPENCODE_ALWAYS_NOTIFY_UPDATE: truthy("OPENCODE_ALWAYS_NOTIFY_UPDATE"),

OPENCODE_BUMP: process.env["OPENCODE_BUMP"],

OPENCODE_CHANNEL: process.env["OPENCODE_CHANNEL"],

OPENCODE_DISABLE_AUTOCOMPACT: truthy("OPENCODE_DISABLE_AUTOCOMPACT"),

OPENCODE_DISABLE_AUTOUPDATE: truthy("OPENCODE_DISABLE_AUTOUPDATE"),

const fff = process.env["OPENCODE_DISABLE_FFF"]
OPENCODE_DISABLE_FFF: fff === undefined ? process.platform === "win32" : truthy("OPENCODE_DISABLE_FFF"),

OPENCODE_DISABLE_MOUSE: truthy("OPENCODE_DISABLE_MOUSE"),

OPENCODE_DISABLE_PRUNE: truthy("OPENCODE_DISABLE_PRUNE"),

OPENCODE_DISABLE_TERMINAL_TITLE: truthy("OPENCODE_DISABLE_TERMINAL_TITLE"),

const value = process.env.CLAUDE_CODE_SSE_PORT || process.env.OPENCODE_EDITOR_SSE_PORT

OPENCODE_FAKE_VCS: process.env["OPENCODE_FAKE_VCS"],

skipInitialLoading: Boolean(process.env.OPENCODE_FAST_BOOT),

OPENCODE_GIT_BASH_PATH: process.env["OPENCODE_GIT_BASH_PATH"],

process.env.OPENCODE_PID = String(process.pid)

OPENCODE_RELEASE: process.env["OPENCODE_RELEASE"],

OPENCODE_VERSION: process.env["OPENCODE_VERSION"],

process.env.VSCODE_EXTENSIONS,

const zedTerminal = process.env.ZED_TERM === "true" || process.env.TERM_PROGRAM?.toLowerCase() === "zed"
return process.env.ZED_TERM === "true" || process.env.TERM_PROGRAM?.toLowerCase() === "zed"

[which("pwsh"), which("powershell"), gitbash(), process.env.COMSPEC || "cmd.exe"]
const defaultShell = () => (process.platform === "win32" ? (process.env.COMSPEC ?? "cmd.exe") : "/bin/sh")

: process.env.DISPLAY

process.env.DOTNET_CLI_HOME ?? os.homedir(),

const editor = process.env.VISUAL || process.env.EDITOR

const v = process.env["GIT_ASKPASS"]

const value = process.env["OIDC_BASE_URL"]

process.env.OPENCODE = "1"

const base = env?.PATH ?? env?.Path ?? process.env.PATH ?? process.env.Path ?? ""

pathExt: env?.PATHEXT ?? env?.PathExt ?? process.env.PATHEXT ?? process.env.PathExt,

const root = Filesystem.resolve(process.env.PWD ?? process.cwd())
export function resolveThreadDirectory(project?: string, envPWD = process.env.PWD, cwd = process.cwd()) {

defaultPreferred ??= select(process.env.SHELL)
defaultAcceptable ??= select(process.env.SHELL, { acceptable: true })
const shell = path.basename(process.env.SHELL || "bash")

multiplexer: process.env.TMUX ? "tmux" : process.env.STY ? "screen" : undefined,
process.stdout.write(process.env.TMUX ? sequence + passthrough : process.env.STY ? passthrough : sequence)
const multiplexer = process.env.TMUX ? " in tmux" : process.env.STY ? " in screen" : ""

const terminal = [termProgram, process.env.TERM].filter((item): item is string => Boolean(item)).join(" / ")
const program = process.env.TERM_PROGRAM || process.env.TERM || "unknown"

const termProgram = process.env.TERM_PROGRAM
? `${process.env.TERM_PROGRAM}${process.env.TERM_PROGRAM_VERSION ? ` ${process.env.TERM_PROGRAM_VERSION}` : ""}`
if (process.env["TERM_PROGRAM"] === "vscode") {

? `${process.env.TERM_PROGRAM}${process.env.TERM_PROGRAM_VERSION ? ` ${process.env.TERM_PROGRAM_VERSION}` : ""}`
const version = process.env.TERM_PROGRAM_VERSION ? ` ${process.env.TERM_PROGRAM_VERSION}` : ""

multiplexer: process.env.TMUX ? "tmux" : process.env.STY ? "screen" : undefined,
process.stdout.write(process.env.TMUX ? sequence + passthrough : process.env.STY ? passthrough : sequence)
const multiplexer = process.env.TMUX ? " in tmux" : process.env.STY ? " in screen" : ""

const potentialVenvPaths = [process.env["VIRTUAL_ENV"], path.join(root, ".venv"), path.join(root, "venv")].filter(

const editor = process.env.VISUAL || process.env.EDITOR

displayServer: process.env.WAYLAND_DISPLAY
const native = copyCommand(platform(), Boolean(process.env.WAYLAND_DISPLAY), (name) => Boolean(which(name)))