From 271810c808f44ca8cc9ead5d80283d7c18c32b70 Mon Sep 17 00:00:00 2001 From: Mario Zechner Date: Wed, 12 Nov 2025 23:25:29 +0100 Subject: [PATCH] docs: add Background Bash section before Planned Features - Clear stance: no background bash execution - Alternative: use tmux or tterminal-cp - Link to tterminal-cp repo - Rationale: long-running commands need proper terminal sessions --- packages/coding-agent/README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/packages/coding-agent/README.md b/packages/coding-agent/README.md index d67f736e..9d351c80 100644 --- a/packages/coding-agent/README.md +++ b/packages/coding-agent/README.md @@ -453,6 +453,12 @@ Working on step 3 - authorization endpoints The agent can read, update, and reference the plan as it works. Unlike ephemeral planning modes that only exist within a session, file-based plans persist and can be versioned with your code. +## Background Bash + +**pi does not and will not implement background bash execution.** Instead, tell the agent to use `tmux` or something like [tterminal-cp](https://github.com/badlogic/tterminal-cp). + +Long-running commands belong in proper terminal sessions, not as detached processes that complicate cleanup and monitoring. + ## Planned Features Things that might happen eventually: