Menu
Managed background terminals, bg_start/bg_status/bg_list/bg_kill, /ps, dev servers, watchers, or concurrent long-running shell commands. Not for timers or durable tasks.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Pi extensions and tool policy: extensions/*.ts, hooks, registerTool, promptGuidelines, registerCommand, footer/status UI, tool_result, session hooks, or subprocesses. Not for slash-command placement; use pi-command.
README, CHANGELOG, docs/, RFCs, ADRs, guides, or Markdown structure. Not for prose cleanup or archival work.
Prose cleanup for filler, hype, vague claims, repetition, detection tells, or uncited specifics. Not for Markdown architecture or archival work.
Requirements, user stories, acceptance/verification criteria, or testable outcomes. Not for PRD drafting (/prd) or Pi /goal prompts.
Use for /prd-it or to draft, refine, or review a Product Requirements Document. Not for acceptance criteria, planning, or Pi /goal prompts.
Pi session, trace, metrics, routing, workflow-friction, workflow-telemetry, usage, or local JSONL analysis with DuckDB. Use for aggregating or correlating Pi runtime logs. Not for adding telemetry, generic SQL/database design, or non-Pi logs.
| name | background-terminals |
| description | Managed background terminals, bg_start/bg_status/bg_list/bg_kill, /ps, dev servers, watchers, or concurrent long-running shell commands. Not for timers or durable tasks. |
Use managed background terminals for long-lived Bash processes such as development servers, file watchers, and concurrent command work.
bg_start; its command is evaluated by damage-control before any process is spawned.PI_BACKGROUND_SHELL to an absolute Bash path only when the normal Pi-compatible shell resolution is insufficient.task records when workflow intent must survive the current process.bg_status. Natural completion is delivered automatically; inspect status only when current output is needed.bg_kill to terminate managed process trees. /ps provides a live list and bounded stdout/stderr detail view./ps to locate session-local log paths when more output is needed.