std-env - GitLite

KO | EN

gitlite — search

#javascript #ai #typescript #golang #machine-learning #deep-learning #docker #nodejs #java #kubernetes #awesome-list #ios #openai #open-source

std-env

(★ 639)

Runtime Agnostic Env Info

File Explorer

Download Latest Version (.zip)

- - autofix.yml
  - ci.yml
- agents.ts
- env.ts
- flags.ts
- index.ts
- providers.ts
- runtimes.ts
- - agents.ts
- agents.test.ts
- bundle.test.ts
- index.test.ts
.gitignore
.oxfmtrc.json
.oxlintrc.json
AGENTS.md
build.config.ts
CHANGELOG.md
CLAUDE.md
LICENCE
package.json
pnpm-lock.yaml
pnpm-workspace.yaml
README.md
renovate.json
tsconfig.json

# Installation Guide

1. Get the code

git clone https://github.com/unjs/std-env

Downloads the entire project code from GitHub to your computer.

cd std-env

Moves into the project folder you just downloaded.

2. Node.js

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

npm install

Downloads and installs the libraries listed in package.json.

npm start

Starts the development/run server.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# std-env

[![npm version](https://img.shields.io/npm/v/std-env.svg?style=flat-square)](http://npmjs.com/package/std-env)
[![npm downloads](https://img.shields.io/npm/dm/std-env.svg?style=flat-square)](http://npmjs.com/package/std-env)
[![bundle size](https://img.shields.io/bundlephobia/min/std-env/latest.svg?style=flat-square)](https://bundlephobia.com/result?p=std-env)

Runtime-agnostic JS utils for detecting environments, runtimes, CI providers, and AI coding agents.

## Runtime Detection

Detects the current JavaScript runtime based on global variables, following the [WinterCG Runtime Keys proposal](https://runtime-keys.proposal.wintercg.org/).

```ts
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`

> [!NOTE]
> `isNode` is also `true` in Bun/Deno with Node.js compatibility mode. Use `runtime === "node"` for strict checks.

See [./src/runtimes.ts](./src/runtimes.ts) for the full list.

## Provider Detection

Detects the current CI/CD provider based on environment variables.

```ts
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](./src/providers.ts) for the full list.

## Agent Detection

Detects if the environment is running inside an AI coding agent.

```ts
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. Use `detectAgent()` to re-run detection.

Supported agents: `cursor`, `claude`, `devin`, `replit`, `gemini`, `codex`, `auggie`, `opencode`, `kiro`, `goose`, `pi`, `junie`

## Flags

```js
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                    |
| `isProduction`     | `NODE_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`)                     |

See [./src/flags.ts](./src/flags.ts) for details.

## Environment

| 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)        |

## License

MIT