@oh-my-pi-zen/pi-utils

Shared utilities for oh-my-pi packages. Zero ceremony, Bun-first.

Notable modules

| Module | Purpose | | --- | --- | | logger | Centralized logger writing to ~/.omp/logs/ with rotation (TUI-safe — never stdout) | | prompt | Handlebars-based prompt templating and formatting helpers | | dirs | Path helpers for omp config directories (~/.omp, XDG-aware on Linux) | | stream | readStream / readLines helpers over ReadableStream | | ptree / procmgr | Process trees, ChildProcess wrapper, process lifecycle management | | postmortem | Cleanup callbacks on exit, signals, and fatal exceptions | | which | $which() binary lookup with caching | | fetch-retry | fetch with retry/backoff policies | | fs-error | Errno guards (isEnoent and friends) | | env / worker-host | Environment plumbing and side-effect-free worker-host entry contract (workerHostEntry) | | abortable / async | AbortSignal-aware stream/promise helpers | | peek-file | Read the first N bytes of a file with pooled buffers | | frontmatter, glob, mime, temp, format, color, snowflake, tab-spacing, path-tree, sanitize-text | Smaller single-purpose helpers |

Import from the root barrel or per-module subpaths (@oh-my-pi-zen/pi-utils/<module>).

Install

bun add @oh-my-pi-zen/pi-utils

Ships TypeScript source directly (no build step); requires Bun ≥ 1.3.14.

References

• Monorepo README
• CHANGELOG