omp packages

@finngi/pi-background0.1.0-alpha.0

Managed Bash and session-owned background processes for Pi

finngi Published 7 days ago MIT ~211 downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Did it work for you?

Result

One report per person. A new report replaces your old one.

Reports 0

No reports yet.

Readme

@finngi/pi-background

Experimental alpha; tested with Node 24 and stock Pi 1.2.0.

pi install npm:@finngi/pi-background@0.1.0-alpha.0

This download includes its workspace dependencies. No sibling packages are required.

Background Bash jobs for stock Pi. It works on its own, without delegation, goals or a custom launcher. Commands run with your normal user permissions; the optional permission package can check them first.

  • bash keeps Pi's usual schema and results, and adds background: true to return a job ID at once.
  • background_process lets the model list, inspect, read and cancel this session's jobs.
  • /jobs does the same for you. /background, or a steering message, ends a foreground wait while the command keeps running.

Output is kept up to a limit. Shell jobs and child agents have separate limits, four and sixteen by default. Delegation can share this manager or use the process library directly. Children get the selected Bash and background tools and own their jobs; they cannot see a sibling's jobs. Shutdown stops jobs, old handles cannot touch a new session, and jobs are not restarted on resume. Process groups clean up ordinary child processes, but not ones that deliberately detach.

Tests

npm test --workspace=pi-background
npm run test:standalone --workspace=pi-background

The standalone test starts stock Pi with only this package, runs, reads and cancels jobs, and checks cleanup on shutdown. It makes no provider requests and changes no installation.

See the jobs guide, tool reference, service and testing.