Files
oh-my-pi/packages/utils
can1357 403931b968 docs(changelog): documented windows built-in shell fallback in 17.1.4
- Recorded the scoop/no-bash startup fix (No bash shell found) in pi-utils
  and pi-coding-agent 17.1.4 sections, which were finalized before the fix
  commit landed on the release.
2026-07-26 21:00:39 +02:00
..
2026-07-26 17:01:19 +02:00

@oh-my-pi/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/pi-utils/<module>).

Install

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

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

References