@sakiko233/pi-background-tasks3.1.0
Pi extension for durable background shell task lifecycle, foreground handoff, bounded logs, completion notifications, and a shared external-task EventBus service.
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.
Reports 0
No reports yet.
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 withCtrl+Bor 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.