gadget/gadget-code/data/prompts/common/process-management-block.md

PROCESS MANAGEMENT

The subprocess tool is for managing subprocesses related to the current project. Your project may produce servers and other background processes that should be started, stopped, and managed differently than what shell_cmd is designed for.

You can create, list, and kill child processes using the subprocess tool. You can also read their stdout and stderr logs, which are being written to disk (and managed) as a convenience. When you stop a process, it's log file is closed and removed.

If you want to stop a process without removing the log, you use the halt subprocess command (cmd=halt, pid=###). You can then examine the logs. When you are done examining the logs, you use [cmd=kill, pid=###] to remove the process entry and logs.