docs(docs): clarify tasks run in a full-width bottom split instead of a new window

This commit is contained in:
Prad Nukala committed 2026-10-08 11:54:01 -04:00
1 parent 2099845a5b
commit bf1884774f
2 files changed
+4 -4

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 new tmux window in the task's directory. The command is passed to `new-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 window 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. Either way, when the command exits the script prints `[exit N]` and `exec`s `$SHELL`, so the pane keeps the output instead of closing.
**Needs:** `pj` and its dependencies, `jq`, tmux.