package
Runtime agnostic JS utils
npm install std-envGitHub-flavored package documentation.
Across all versions.
Download trend unavailable.
Runtime metadata.
Estimated unpacked size across 1 packages.
17.7 kB
Includes dependencies.
Runtime-agnostic JS utils for detecting environments, runtimes, CI providers, and AI coding agents.
Detects the current JavaScript runtime based on global variables, following the WinterCG Runtime Keys proposal.
import { runtime, runtimeInfo } from "std-env";
console.log(runtime); // "" | "node" | "deno" | "bun" | "workerd" ...
console.log(runtimeInfo); // { name: "node" }Individual named exports: isNode, isBun, isDeno, isNetlify, isEdgeLight, isWorkerd, isFastly, isNub
[!NOTE]
isNodeis alsotruein Bun/Deno with Node.js compatibility mode. Useruntime === "node"for strict checks.
isNubdetects Nub, which augments Node.js rather than replacing it. It is additive:isNodeis alsotrueandruntimestays"node".
See ./src/runtimes.ts for the full list.
Detects the current CI/CD provider based on environment variables.
import { isCI, provider, providerInfo } from "std-env";
console.log({ isCI, provider, providerInfo });
// { isCI: true, provider: "github_actions", providerInfo: { name: "github_actions", ci: true } }Use detectProvider() to re-run detection. See ./src/providers.ts for the full list.
Detects if the environment is running inside an AI coding agent.
import { isAgent, agent, agentInfo } from "std-env";
console.log({ isAgent, agent, agentInfo });
// { isAgent: true, agent: "claude", agentInfo: { name: "claude" } }Set the AI_AGENT env var to explicitly specify the agent name. GitHub Copilot aliases github_copilot_vscode_agent and github_copilot_cloud_agent are normalized to copilot. Use detectAgent() to re-run detection.
Supported agents: cursor, claude, copilot, devin, replit, gemini, codex, auggie, opencode, kiro, goose, pi, junie
import { env, isDevelopment, isProduction } from "std-env";| Export | Description |
|---|---|
hasTTY | stdout TTY is available |
hasWindow | Global window is available |
isCI | Running in CI |
isColorSupported | Terminal color output supported |
isDebug | DEBUG env var is set |
isDevelopment | NODE_ENV is dev/development or MODE is development |
isLinux | Linux platform |
isMacOS | macOS (darwin) platform |
isMinimal | MINIMAL env is set, CI, test, or no TTY |
See ./src/flags.ts for details.
| Export | Description |
|---|---|
env | Universal process.env (works across all runtimes) |
process | Universal process shim (works across all runtimes) |
nodeENV | Current NODE_ENV value (undefined if unset) |
MIT
isProductionNODE_ENV or MODE is production |
isTest | NODE_ENV is test or TEST env is set |
isWindows | Windows platform |
platform | Value of process.platform |
nodeVersion | Node.js version string (e.g. "22.0.0") |
nodeMajorVersion | Node.js major version number (e.g. 22) |