docs(docs): clarify run pane exit behavior and task closing instructions

This commit is contained in:
Prad Nukala committed 2026-10-08 12:41:54 -04:00
1 parent ed3e1bd101
commit b1654495a1
2 files changed
+2 -2

No files matched your search

+1 -1
View File
@@ -355,7 +355,7 @@ With no arguments it reads the active pane's directory (`tmux display -p '#{pane
The project root is the git toplevel, else the pane's directory.
**Run.** Every item opens a full-width split along the bottom of the window (`split-window -v -f -l 25%`), 25% of its height, in the task's directory. The command is passed to `split-window` as separate arguments, so no shell reparses it. `--run` calls `pj --run`, which keeps pj's `openlogs` wrapping of `dev`/`start`/`serve`/`watch` tasks, and `--cmd` runs a quick action. Either way, when the command exits the script prints `[exit N]` and `exec`s `$SHELL`, so the pane keeps the output instead of closing.
**Run.** Every item opens a full-width split along the bottom of the window (`split-window -v -f -l 25%`), 25% of its height, in the task's directory. The command is passed to `split-window` as separate arguments, so no shell reparses it. `--run` calls `pj --run`, which keeps pj's `openlogs` wrapping of `dev`/`start`/`serve`/`watch` tasks, and `--cmd` runs a quick action. While the command runs, <kbd>ctrl-c</kbd> stops only the command (the script traps `SIGINT`), so the output stays. Once the command exits, the script prints `[exit N] enter or ctrl-c to close`, and <kbd>enter</kbd> or <kbd>ctrl-c</kbd> closes the pane; other keys are ignored.
**Needs:** `pj` and its dependencies, `jq`, tmux.