@sakiko233/pi-background-tasks

Pi extension for durable background shell task lifecycle, foreground handoff, bounded logs, completion notifications, and a shared external-task EventBus service.

Packages

Package details

extension

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

npm repo home report

$ pi install npm:@sakiko233/pi-background-tasks

Package: @sakiko233/pi-background-tasks
Version: 3.1.0
Published: Aug 28, 2026
Downloads: 1,196/mo · 72/wk
Author: sakiko233
License: ISC
Types: extension
Size: 413.4 KB
Dependencies: 0 dependencies · 3 peers

Pi manifest JSON

{
  "image": "https://raw.githubusercontent.com/SakikoTogawa233/pi-background-tasks/main/logo.png",
  "extensions": [
    "./extensions/background-tasks.ts"
  ]
}

Security note

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

README

@sakiko233/pi-background-tasks

Durable background shell task lifecycle for Pi.

Fact	Value
Package	`@sakiko233/pi-background-tasks`
Version	`3.1.0`
Node engine	`>=22.19.0`
Pi entrypoints	`./extensions/background-tasks.ts`
Package image	logo.png

Surface kind	Count
command	8
tool	5
shortcut	3
renderer	1
eventbus	2
workflow	0

Public commands: /bg, /bg-clear, /bg-tasks, /bg-update, /jobs, /kill, /logs, /tasks.

Public tools: bash, bg_kill, bg_logs, bg_run, bg_status.

Full owner map and generated contracts live in docs/INDEX.md.

Install

pi install npm:@sakiko233/pi-background-tasks

Public tools

bash — foreground shell with Ctrl+B or timed handoff in TUI mode.
bg_run — start a named background command and return immediately.
bg_status — inspect one task or recent tasks.
bg_logs — read bounded output.
bg_kill — stop a running task.

Commands and UI

/bg, /jobs, /logs, /kill, /tasks, /bg-tasks, /bg-clear, and /bg-update share one registry, one dedicated task-status row above Pi's native footer, and one footer dock. Running tasks and unseen successful completions use the dedicated row at every terminal width; update-only notices remain in the native footer. Completion notifications are durable terminal truth and can trigger one follow-up turn.

EventBus

The package preserves the closed shell EventBus v1 contract and provides a closed external-task EventBus v2 contract. V2 supports handshake, registration, generic updates, bounded log append, correlated cancellation acknowledgement, settlement, status, logs, kill, and terminal publication. External snapshots contain only generic task facts, an owner reference, and generic capabilities.

See docs/api/eventbus-v1.md for both versions.