---
slug: "alexgorbatchev-pi-env"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/alexgorbatchev/pi-env@main/README.md"
repo: "https://github.com/alexgorbatchev/pi-env"
source_file: "README.md"
branch: "main"
---
# @alexgorbatchev/pi-env

A Pi extension that injects environment variables defined in Pi's settings into the active agent process, allowing child processes (like `bash` commands and `process` services) to inherit them.

## Installation

To install this extension globally (for all your Pi sessions):

```bash
pi install npm:@alexgorbatchev/pi-env
```

To install it locally (for a single project):

```bash
pi install npm:@alexgorbatchev/pi-env -l
```

## Configuration

Define environment variables under the `"@alexgorbatchev/pi-env"` key in your settings (either globally or per-project). Both keys and values must be strings.

> [!IMPORTANT]
> Do not store secrets such as API keys, access tokens, or passwords in this extension's settings. The extension currently displays configured values in the Pi UI when a session starts, so only use non-sensitive configuration here.

Example `.pi/settings.json`:

```json
{
  "@alexgorbatchev/pi-env": {
    "APP_ENV": "development",
    "API_URL": "http://localhost:3000"
  }
}
```

When Pi runs, these variables are displayed in the session output and assigned to `process.env`. Use `/env` to print the same report again.