opencode-workspace-env 0.1.0 → 0.1.1

package/README.md

@@ -2,16 +2,16 @@
 
 Per-workspace environment injection for OpenCode.
 
-`opencode-workspace-env` is an OpenCode plugin that injects per-workspace env vars into every shell execution via the `shell.env` hook. It lets one OpenCode server work across multiple repos, each with its own nix or direnv environment.
+`opencode-workspace-env` is an OpenCode plugin that injects per-workspace env vars into every shell execution via the `shell.env` hook. It lets one OpenCode server work across multiple repos, each with its own direnv or nix environment.
 
 ## What This Does
 
-OpenCode agents often need different toolchains per workspace — different Node, Python, or nix environments. This plugin resolves the nearest env source from the current working directory, loads env vars, and injects them into the shell command that is about to run.
+OpenCode agents often need different toolchains per workspace — different Node, Python, or system packages. This plugin resolves the nearest env source from the current working directory, loads env vars, and injects them into the shell command that is about to run.
 
 Two env source paths are supported:
 
-1. **`.envrc`** (primary) — uses `direnv export json`
-2. **`flake.nix`** (fallback) — uses `nix print-dev-env --json` directly, no `.envrc` or direnv needed
+1. **`.envrc`** (primary) — runs `direnv export json`. The `.envrc` can contain anything direnv supports (`use flake`, `layout python`, plain exports, etc.).
+2. **`flake.nix`** (fallback) — runs `nix print-dev-env --json` directly. No direnv needed.
 
 ```text
 Agent runs shell command
@@ -38,8 +38,8 @@ Add it to `opencode.json`:
 ```
 
 Prerequisites:
-- **direnv** must be installed globally on the host (for `.envrc` path)
-- **nix** must be installed (for `flake.nix` fallback path — only needed if you have repos without `.envrc`)
+- **direnv** — Required for the `.envrc` path. Must be installed globally on the host, not inside the devShell.
+- **nix** — Required for the `flake.nix` fallback path. Also needed if your `.envrc` uses `use flake`.
 
 ## Usage
 
@@ -51,14 +51,14 @@ printf 'use flake\n' > .envrc
 direnv allow
 ```
 
-### With `flake.nix` only (no `.envrc` needed)
+### With `flake.nix` only (no direnv needed)
 
 ```bash
 # just have a flake.nix with devShells.default — plugin detects it automatically
 git add flake.nix
 ```
 
-With the plugin enabled, any OpenCode shell command run inside that repo gets the exported environment for that workspace. Resolution stops at the git root, so a parent directory outside the repo is never used.
+With the plugin enabled, any OpenCode shell command run inside that repo gets the exported environment for that workspace. Resolution walks up from cwd and stops at the git root, so a parent directory outside the repo is never used.
 
 ## Architecture
 
@@ -66,10 +66,10 @@ With the plugin enabled, any OpenCode shell command run inside that repo gets th
 src/
 ├── index.ts    # Plugin entry. shell.env hook, dispatches envrc vs flake
 ├── resolve.ts  # cwd → ResolvedEnvSource (.envrc first, flake.nix fallback)
-├── direnv.ts   # `direnv export json` → ExportEnvResult
-├── nix.ts      # `nix print-dev-env --json` → NixEnvResult
+├── direnv.ts   # `direnv export json` → EnvExportResult
+├── nix.ts      # `nix print-dev-env --json` → EnvExportResult
 ├── filter.ts   # Shared env key filter (DIRENV_*, NIX_BUILD_*, nix internals)
-└── cache.ts    # In-memory cache keyed by source path + SHA-256 fingerprint
+└── cache.ts    # In-memory cache keyed by source path + SHA-256 fingerprint (max 50 entries, FIFO eviction)
 ```
 
 - Writes only to `output.env`, never `process.env`
@@ -84,6 +84,7 @@ src/
 - `flake.nix` must be `git add`ed for nix to see it
 - `direnv` must be globally installed, not inside the devShell
 - `nix print-dev-env` can be slow on first eval (~10s+), cached after
+- In-memory cache holds up to 50 workspaces; oldest entries are evicted first (FIFO)
 
 ## License
 

package/dist/filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AAoDA,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKrD"}
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AAyDA,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKrD"}

package/dist/filter.js

@@ -2,6 +2,11 @@
 const EXCLUDED_PREFIXES = ["DIRENV_", "NIX_BUILD_", "__"];
 /** Known nix build-system variables that should not leak into shell env */
 const EXCLUDED_VARS = new Set([
+    "HOME",
+    "USER",
+    "LOGNAME",
+    "SHELL",
+    "HOSTNAME",
     "name",
     "system",
     "builder",

package/dist/filter.js.map

@@ -1 +1 @@
-{"version":3,"file":"filter.js","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;AAE1D,2EAA2E;AAC3E,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,MAAM;IACN,QAAQ;IACR,SAAS;IACT,KAAK;IACL,KAAK;IACL,SAAS;IACT,QAAQ;IACR,WAAW;IACX,oBAAoB;IACpB,gBAAgB;IAChB,kBAAkB;IAClB,gBAAgB;IAChB,eAAe;IACf,YAAY;IACZ,YAAY;IACZ,gBAAgB;IAChB,cAAc;IACd,YAAY;IACZ,WAAW;IACX,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,mBAAmB;IACnB,uBAAuB;IACvB,6BAA6B;IAC7B,gBAAgB;IAChB,0BAA0B;IAC1B,eAAe;IACf,yBAAyB;IACzB,iBAAiB;IACjB,2BAA2B;IAC3B,cAAc;IACd,wBAAwB;IACxB,kBAAkB;IAClB,4BAA4B;IAC5B,QAAQ;IACR,YAAY;IACZ,OAAO;IACP,wBAAwB;IACxB,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,qBAAqB;IACrB,mBAAmB;CACpB,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AACpE,CAAC"}
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;AAE1D,2EAA2E;AAC3E,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,MAAM;IACN,MAAM;IACN,SAAS;IACT,OAAO;IACP,UAAU;IACV,MAAM;IACN,QAAQ;IACR,SAAS;IACT,KAAK;IACL,KAAK;IACL,SAAS;IACT,QAAQ;IACR,WAAW;IACX,oBAAoB;IACpB,gBAAgB;IAChB,kBAAkB;IAClB,gBAAgB;IAChB,eAAe;IACf,YAAY;IACZ,YAAY;IACZ,gBAAgB;IAChB,cAAc;IACd,YAAY;IACZ,WAAW;IACX,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,mBAAmB;IACnB,uBAAuB;IACvB,6BAA6B;IAC7B,gBAAgB;IAChB,0BAA0B;IAC1B,eAAe;IACf,yBAAyB;IACzB,iBAAiB;IACjB,2BAA2B;IAC3B,cAAc;IACd,wBAAwB;IACxB,kBAAkB;IAClB,4BAA4B;IAC5B,QAAQ;IACR,YAAY;IACZ,OAAO;IACP,wBAAwB;IACxB,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,qBAAqB;IACrB,mBAAmB;CACpB,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import type { Plugin } from "@opencode-ai/plugin";
 export declare const name = "opencode-workspace-env";
-export declare const version = "0.1.0";
+export declare const version = "0.1.1";
 export declare const description = "OpenCode plugin for per-workspace env injection via shell.env hook";
 declare const plugin: Plugin;
 export default plugin;

package/dist/index.js

@@ -3,7 +3,7 @@ import { exportEnv } from "./direnv.js";
 import { exportNixEnv } from "./nix.js";
 import { resolveEnvSource } from "./resolve.js";
 export const name = "opencode-workspace-env";
-export const version = "0.1.0";
+export const version = "0.1.1";
 export const description = "OpenCode plugin for per-workspace env injection via shell.env hook";
 const cache = new EnvCache();
 const plugin = async (_input) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-workspace-env",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "OpenCode plugin for per-workspace env injection via shell.env hook",
   "type": "module",
   "main": "dist/index.js",
@@ -31,6 +31,8 @@
   "license": "MIT",
   "repository": "github:yimsk/opencode-workspace-env",
   "devDependencies": {
+    "@changesets/changelog-github": "^0.6.0",
+    "@changesets/cli": "^2.30.0",
     "@nkzw/oxlint-config": "^1.0.1",
     "@types/bun": "latest",
     "@types/node": "^24.5.2",