@alexgorbatchev/pi-env

Pi extension that injects environment variables from project config settings.

Package details

← Back

extension

Install @alexgorbatchev/pi-env from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@alexgorbatchev/pi-env

Package: @alexgorbatchev/pi-env
Version: 1.0.2
Published: Apr 8, 2026
Downloads: 484/mo · 23/wk
Author: alexgorbatchev
License: MIT
Types: extension
Size: 6.9 KB
Dependencies: 0 dependencies · 1 peer

Pi manifest JSON

{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

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

pi install npm:@alexgorbatchev/pi-env

To install it locally (for a single project):

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:

{
  "@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.