Environment variables
All 132 environment names Studio reads, split into configurable, platform-injected and do-not-set tiers by namespace.
Three tiers
Studio reads 132 environment names from the process environment: 8 through a direct process.env.X read, the rest through an injected env parameter or a *_ENV_NAMES constant array.
| Tier | Identifier | Count | Meaning |
|---|---|---|---|
| Configurable | configurable | 36 | Operators and developers may set these; unset means the code default applies. |
| Platform-injected | platform | 84 | Injected by the container, managed runtime or desktop shell; manual values are usually overwritten or ignored. |
| Do not set | forbidden | 12 | Studio reads these, but the value must come from the credential service or settings UI; never write them into a shell profile, .env or CI variable. |
Credentials come from the settings UI only
Names in the "Do not set" tier are owned by the credential service or settings UI. Writing them into a shell profile, .env or CI variable bypasses the Studio credential boundary and leaks them into logs.
Namespaces
| Namespace | Count | Notes |
|---|---|---|
AGENTKIT | 55 | Studio-owned configuration. |
KSADK | 30 | Runtime knobs for Skills, sandboxes, memory and knowledge bases. |
AGENTENGINE | 11 | Runtime identity and endpoints injected by the AgentEngine control plane. |
OTEL | 10 | Standard OpenTelemetry export variables. |
OTHER | 10 | Standalone names without a namespace prefix. |
DSH | 5 | DSH host (home, agents home, observability). |
E2B | 4 | E2B sandbox backend. |
KSYUN | 3 | Kingsoft Cloud signing credentials. |
CODEX | 1 | Codex App Server home and executable. |
GITHUB | 1 | GitHub access token. |
KS3 | 1 | KS3 bucket and endpoint. |
OPENAI | 1 | OpenAI-compatible endpoint and key. |
Full list
Grouped by namespace. Each row cites the first read site; later reads of the same name are omitted.
| Environment name | Tier | First read |
|---|---|---|
AGENTKIT_STUDIO_HOST_URL | Configurable | src/authoring-tools.mjs |
AGENTKIT_STUDIO_HOST_SESSION_TOKEN | Do not set | src/authoring-tools.mjs |
AGENTKIT_HOME | Configurable | src/authoring-tools.mjs |
AGENTKIT_STUDIO_NATIVE_HARNESS | Platform-injected | src/build-engine.mjs |
AGENTKIT_RUNTIME_TOKEN | Do not set | src/bundle-host.mjs |
AGENTKIT_BUNDLE_SOURCE | Platform-injected | src/bundle-source.mjs |
AGENTKIT_BUNDLE_SHA256 | Platform-injected | src/bundle-source.mjs |
AGENTKIT_STUDIO_DSH_PLUGIN_INDEX | Configurable | src/dsh-plugin-catalog.mjs |
AGENTKIT_STUDIO_GITHUB_TOKEN | Do not set | src/dsh-plugin-discovery.mjs |
AGENTKIT_STUDIO_DISCOVERY_CACHE | Configurable | src/dsh-plugin-discovery.mjs |
AGENTKIT_RUNTIME_TIMEOUT_MS | Platform-injected | src/frozen-build-runtime.mjs |
AGENTKIT_RUNTIME_AGENT_ID | Platform-injected | src/frozen-build-runtime.mjs |
AGENTKIT_RUNTIME_BUILD_ID | Platform-injected | src/frozen-build-runtime.mjs |
AGENTKIT_EXECUTION_POLICY_DEFAULT | Configurable | src/frozen-build-runtime.mjs |
AGENTKIT_EXECUTION_POLICY_MAX | Configurable | src/frozen-build-runtime.mjs |
AGENTKIT_MANAGED_SESSIONS | Configurable | src/frozen-build-runtime.mjs |
AGENTKIT_DEPLOYMENT_VERSION | Platform-injected | src/frozen-build-runtime.mjs |
AGENTKIT_RUNTIME_HOST | Platform-injected | src/frozen-build-runtime.mjs |
AGENTKIT_RUNTIME_PORT | Platform-injected | src/frozen-build-runtime.mjs |
AGENTKIT_STRICT_RESOURCES | Configurable | src/host/bootstrap.mjs |
AGENTKIT_STUDIO_BUNDLE_DIR | Platform-injected | src/host/bootstrap.mjs |
AGENTKIT_STUDIO_WORKSPACE | Platform-injected | src/host/bootstrap.mjs |
AGENTKIT_STUDIO_NATIVE_CHROMIUM_EXECUTABLE | Platform-injected | src/host/bootstrap.mjs |
AGENTKIT_MCP_INVOCATION_IDENTITY | Configurable | src/host/services/resources.mjs |
AGENTKIT_ENGINE_SERVICE_TOKEN | Do not set | src/host/services/star-harness-worker.mjs |
AGENTKIT_KS3_ENDPOINT_MODE | Configurable | src/ks3-endpoints.mjs |
AGENTKIT_MCP_BUSINESS_IDENTITY | Configurable | src/managed-runtime-actions.mjs |
AGENTKIT_MODEL_API_KEY | Do not set | src/managed-runtime-definition.mjs |
AGENTKIT_MANAGED_CODEX_API | Configurable | src/managed-runtime-definition.mjs |
AGENTKIT_ENGINE_SERVICE_URL | Platform-injected | src/managed-runtime-definition.mjs |
AGENTKIT_ENGINE_SERVICE_CA_FILE | Platform-injected | src/managed-runtime-definition.mjs |
AGENTKIT_ENGINE_SERVICE_WORKSPACE | Platform-injected | src/managed-runtime-definition.mjs |
AGENTKIT_USER_HOME | Platform-injected | src/managed-runtime-host.mjs |
AGENTKIT_WORKSPACE_ROOT | Configurable | src/managed-runtime-host.mjs |
AGENTKIT_CODEX_MODEL | Configurable | src/managed-runtime-host.mjs |
AGENTKIT_CODEX_SANDBOX | Configurable | src/managed-runtime-host.mjs |
AGENTKIT_CODEX_APPROVAL_POLICY | Configurable | src/managed-runtime-host.mjs |
AGENTKIT_CODEX_REASONING_SUMMARY | Configurable | src/managed-runtime-host.mjs |
AGENTKIT_CODEX_TIMEOUT_MS | Configurable | src/managed-runtime-host.mjs |
AGENTKIT_CODEX_IDLE_TIMEOUT_MS | Configurable | src/managed-runtime-host.mjs |
AGENTKIT_CODEX_STREAM_IDLE_TIMEOUT_MS | Configurable | src/managed-runtime-host.mjs |
AGENTKIT_CODEX_MODEL_IDLE_TIMEOUT_MS | Configurable | src/managed-runtime-host.mjs |
AGENTKIT_PROMPT_PREDICTION_ENABLED | Configurable | src/prompt-prediction/host.mjs |
AGENTKIT_PROMPT_PREDICTION_AUDIT | Configurable | src/prompt-prediction/host.mjs |
AGENTKIT_CODEX_BIN | Configurable | src/providers/codex-command.mjs |
AGENTKIT_ENGINE_SERVICE_WORKSPACES | Platform-injected | src/providers/engine-service-workspaces.mjs |
AGENTKIT_ENGINE_SERVICE_MODEL | Platform-injected | src/providers/engine-service-workspaces.mjs |
AGENTKIT_STUDIO_NATIVE_APPLICATION_PREVIEW_ORIGIN | Platform-injected | src/providers/engine-service-workspaces.mjs |
AGENTKIT_STUDIO_NATIVE_APPLICATION_PREVIEW_ENTRY | Platform-injected | src/providers/engine-service-workspaces.mjs |
AGENTKIT_STUDIO_DEPLOYMENT_TYPE | Platform-injected | src/studio-deployments.mjs |
AGENTKIT_STUDIO_DESKTOP_VERSION | Platform-injected | src/studio-version.mjs |
AGENTKIT_STUDIO_DSH_VERSION | Platform-injected | src/studio-version.mjs |
AGENTKIT_TEMPLATE_SERVER_URL | Configurable | src/template-catalog-source.mjs |
AGENTKIT_TEMPLATE_CATALOG_FILE | Configurable | src/template-catalog-source.mjs |
AGENTKIT_TEMPLATE_ENVIRONMENT | Configurable | src/template-catalog-source.mjs |
KSADK_TRAFFIC_SOURCE | Platform-injected | src/aicp-resource-connection.mjs |
KSADK_LOCAL_SKILLS_DIR | Platform-injected | src/host/bootstrap.mjs |
KSADK_MODEL_COMPAT_RULE | Platform-injected | src/host/services/star-harness-release.mjs |
KSADK_KB_DATASET_ID | Platform-injected | src/knowledge-tools.mjs |
KSADK_KB_TOP_K | Platform-injected | src/knowledge-tools.mjs |
KSADK_KB_SEARCH_METHOD | Platform-injected | src/knowledge-tools.mjs |
KSADK_KB_SCORE_THRESHOLD | Platform-injected | src/knowledge-tools.mjs |
KSADK_KB_RERANKING_ENABLE | Platform-injected | src/knowledge-tools.mjs |
KSADK_LTM_BACKEND | Platform-injected | src/legacy-memory-tools.mjs |
KSADK_LTM_INDEX | Platform-injected | src/legacy-memory-tools.mjs |
KSADK_LTM_APP_NAME | Platform-injected | src/legacy-memory-tools.mjs |
KSADK_LTM_NAMESPACE | Platform-injected | src/legacy-memory-tools.mjs |
KSADK_LTM_TOP_K | Platform-injected | src/legacy-memory-tools.mjs |
KSADK_LTM_SCENE_ID | Platform-injected | src/legacy-memory-tools.mjs |
KSADK_LTM_FORCE_INMEMORY | Platform-injected | src/legacy-memory-tools.mjs |
KSADK_LTM_HTTP_TOKEN | Do not set | src/legacy-memory-tools.mjs |
KSADK_MEMORY_DB_PATH | Platform-injected | src/legacy-memory-tools.mjs |
KSADK_LTM_HTTP_URL | Platform-injected | src/legacy-memory-tools.mjs |
KSADK_SANDBOX_BACKEND | Platform-injected | src/providers/native-e2b-host.mjs |
KSADK_SANDBOX_TEMPLATE_ID | Platform-injected | src/providers/native-e2b-host.mjs |
KSADK_SKILL_RUNTIME_TEMPLATE_ID | Platform-injected | src/providers/native-e2b-host.mjs |
KSADK_SANDBOX_TIMEOUT | Platform-injected | src/providers/native-e2b-host.mjs |
KSADK_SKILL_RUNTIME_TIMEOUT | Platform-injected | src/providers/native-e2b-host.mjs |
KSADK_SANDBOX_ALLOW_INTERNET_ACCESS | Platform-injected | src/providers/native-e2b-host.mjs |
KSADK_SKILL_RUNTIME_ALLOW_INTERNET_ACCESS | Platform-injected | src/providers/native-e2b-host.mjs |
KSADK_SANDBOX_TYPE | Platform-injected | src/providers/native-e2b-host.mjs |
KSADK_SKILL_SPACE_IDS | Platform-injected | src/providers/native-skill-host.mjs |
KSADK_SKILL_RUNTIME_BACKEND | Platform-injected | src/providers/native-skill-runtime.mjs |
KSADK_SKILL_PROJECT_NAME | Platform-injected | src/providers/native-skill-runtime.mjs |
KSADK_SKILL_ARTIFACT_PROJECT | Platform-injected | src/providers/native-skill-runtime.mjs |
AGENTENGINE_INNER_KOP_URL | Platform-injected | src/host/bootstrap.mjs |
AGENTENGINE_INNER_IAM_URL | Platform-injected | src/host/bootstrap.mjs |
AGENTENGINE_MANIFEST_PATH | Platform-injected | src/host/bootstrap.mjs |
AGENTENGINE_NETWORK_MODE | Platform-injected | src/ks3-endpoints.mjs |
AGENTENGINE_RESOURCE_SERVER_URL | Platform-injected | src/managed-resource-client.mjs |
AGENTENGINE_AGENT_ID | Platform-injected | src/managed-runtime-definition.mjs |
AGENTENGINE_AGENT_VERSION_ID | Platform-injected | src/managed-runtime-definition.mjs |
AGENTENGINE_MANAGED_RUNTIME_NAME | Platform-injected | src/managed-runtime-manifest.mjs |
AGENTENGINE_MANAGED_RUNTIME_VERSION | Platform-injected | src/managed-runtime-manifest.mjs |
AGENTENGINE_MANIFEST_PROTOCOL | Platform-injected | src/managed-runtime-manifest.mjs |
AGENTENGINE_MANIFEST_SHA256 | Platform-injected | src/managed-runtime-manifest.mjs |
OTEL_EXPORTER_OTLP_PROTOCOL | Platform-injected | src/managed-runtime-host.mjs |
OTEL_EXPORTER_OTLP_HEADERS | Platform-injected | src/managed-runtime-host.mjs |
OTEL_EXPORTER_OTLP_ENDPOINT | Platform-injected | src/managed-runtime-host.mjs |
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT | Platform-injected | src/managed-runtime-host.mjs |
OTEL_EXPORTER_OTLP_TRACES_HEADERS | Platform-injected | src/managed-runtime-host.mjs |
OTEL_EXPORTER_OTLP_TRACES_PROTOCOL | Platform-injected | src/managed-runtime-host.mjs |
OTEL_EXPORTER_OTLP_TRACES_CERTIFICATE | Platform-injected | src/managed-runtime-host.mjs |
OTEL_EXPORTER_OTLP_CERTIFICATE | Platform-injected | src/managed-runtime-host.mjs |
OTEL_SERVICE_NAME | Platform-injected | src/managed-runtime-host.mjs |
OTEL_RESOURCE_ATTRIBUTES | Platform-injected | src/managed-runtime-host.mjs |
PATH | Configurable | src/host/services/star-harness-release.mjs |
STUDIO_DOWNLOAD_PROD_KS3_BUCKET | Platform-injected | src/ks3-release-store.mjs |
DOWNLOAD_PROD_KS3_BUCKET | Platform-injected | src/ks3-release-store.mjs |
CLOUD_MONITOR_OTLP_ENDPOINT | Platform-injected | src/managed-runtime-host.mjs |
CLOUD_MONITOR_OTLP_TRACES_ENDPOINT | Platform-injected | src/managed-runtime-host.mjs |
CLOUD_MONITOR_OTLP_HEADERS | Platform-injected | src/managed-runtime-host.mjs |
CLOUD_MONITOR_OTLP_PROTOCOL | Platform-injected | src/managed-runtime-host.mjs |
CLOUD_MONITOR_OTLP_TRACES_PROTOCOL | Platform-injected | src/managed-runtime-host.mjs |
CLOUD_MONITOR_OTLP_TRACES_HEADERS | Platform-injected | src/managed-runtime-host.mjs |
CLOUD_MONITOR_APP_KEY | Do not set | src/managed-runtime-host.mjs |
DSH_PLUGIN_INDEX_URL | Configurable | src/dsh-plugin-catalog.mjs |
DSH_OTEL_CA_PEM_BASE64 | Platform-injected | src/managed-runtime-host.mjs |
DSH_OBSERVABILITY_CAPTURE_CONTENT | Platform-injected | src/managed-runtime-host.mjs |
DSH_HOME | Configurable | src/providers/native-dsh-tools.mjs |
DSH_AGENTS_HOME | Configurable | src/providers/native-dsh-tools.mjs |
E2B_API_URL | Configurable | src/providers/native-e2b-host.mjs |
E2B_DOMAIN | Configurable | src/providers/native-e2b-host.mjs |
E2B_API_KEY | Do not set | src/providers/native-e2b-host.mjs |
E2B_SANDBOX_URL | Configurable | src/providers/native-e2b-sdk-transport.mjs |
KSYUN_ACCESS_KEY | Do not set | src/bundle-source.mjs |
KSYUN_SECRET_KEY | Do not set | src/bundle-source.mjs |
KSYUN_SESSION_TOKEN | Do not set | src/bundle-source.mjs |
CODEX_HOME | Configurable | src/model-credential-sync.mjs |
GITHUB_TOKEN | Do not set | src/dsh-plugin-discovery.mjs |
KS3_BUCKET | Platform-injected | src/ks3-release-store.mjs |
OPENAI_BASE_URL | Configurable | src/managed-runtime-definition.mjs |
Common settings
| Variable | Default | Purpose |
|---|---|---|
AGENTKIT_HOME | ~/.agentkit | Studio data directory: grants, caches, cloud Skills |
DSH_HOME | ~/.dsh | DSH host directory; point it at a temp directory when developing |
DSH_AGENTS_HOME | ~/.agents | Root for native Tools that resolve an Agent directory |
AGENTKIT_STUDIO_DSH_PLUGIN_INDEX | empty | HTTPS address of a remote plugin index; empty means builtin only |
AGENTKIT_EXECUTION_POLICY_DEFAULT | workspace-write | Default execution policy for a new Agent |
AGENTKIT_EXECUTION_POLICY_MAX | workspace-write | Highest execution policy an Agent may request |
AGENTKIT_STRICT_RESOURCES | empty | Truthy fails on a missing resource instead of degrading |
AGENTKIT_PROMPT_PREDICTION_ENABLED | empty | Enables prompt prediction |
CODEX_HOME | ~/.codex | Codex App Server home |
OPENAI_BASE_URL | empty | OpenAI-compatible endpoint; injected by the platform in container deployments |
Source is authoritative for every default; the Default column only repeats the fallback the code actually reads.
Version and compatibility
| Item | Value | Notes |
|---|---|---|
| Environment names | 132 | Renaming one is a breaking change |
| Direct reads | 8 | process.env.X literals |
| Host forwarded | 30 | Declared by *_ENV_NAMES constant arrays |
| Platform-injected | 84 | Manual values are overwritten |
Developer entry points
| Item | Source |
|---|---|
| Global configuration | src/global-config.mjs |
| Observability | src/observability-otel.mjs |
| Host forwarding allow-list | src/managed-runtime-host.mjs |
| Container deployment environment | src/container-deployment-env.mjs |
| Plugin index address | src/dsh-plugin-index.mjs |
Related tests:
| Test file | Location |
|---|---|
| container-deployment-env.test.mjs | tests/container-deployment-env.test.mjs |
| global-config.test.mjs | tests/global-config.test.mjs |
| portable-bundle.test.mjs | tests/portable-bundle.test.mjs |
| observability-otel.test.mjs | tests/observability-otel.test.mjs |