pi-better-background-tasks

Pi extension for durable background shell tasks, watchers, logs, and status inspection.

Packages

Package details

extension

Install pi-better-background-tasks from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-better-background-tasks
Package
pi-better-background-tasks
Version
0.1.15
Published
Aug 4, 2026
Downloads
1,921/mo · 1,921/wk
Author
exoulster
License
MIT
Types
extension
Size
115.4 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ],
  "image": "https://raw.githubusercontent.com/1aboveio/pi-better-harness/main/docs/images/package-gallery/pi-better-background-tasks.png"
}

Security note

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

README

pi-better-background-tasks

pi-better-background-tasks is a Pi extension for durable background shell tasks, watchers, logs, and status inspection.

Quick Answer

Use pi-better-background-tasks when a command should keep running while the foreground Pi session stays free. It is best for dev servers, long scripts, queue watchers, deploy checks, log tails, and other command-driven work.

Screenshots

Core Features

  • Start long-running commands without blocking the current turn.
  • Watch commands until success, failure, or timeout.
  • Keep task metadata and logs available across reloads.
  • Show active work in Pi's background-work navigator.
  • Flag running tasks with no observable output or completed poll as stalled.

Install

pi install npm:pi-better-background-tasks

Try it for one run:

pi -e npm:pi-better-background-tasks

When To Use

Use this package for shell commands that need logs, status, cancellation, or completion notifications across a Pi turn.

Do not use it for short commands where the foreground session should wait for the result directly.

Compatibility

Requirement Support
Pi Required
Install method pi install npm:pi-better-background-tasks
Development runtime Node.js 22+

Update Or Remove

pi update npm:pi-better-background-tasks
pi remove npm:pi-better-background-tasks

More Detail