Shep 1.249.0: panes in shep tui
❯shep tui opens a feature's shell or agent log in a pane beside the console
tmux · Zellij · WezTerm · kitty
Shep 1.249.0 adds one feature to the terminal console. Pick any feature, press a key, and its shell or its live agent log opens in a split pane beside the console. Here it is in tmux. It also works in Zellij, WezTerm and kitty, and in a plain terminal with no multiplexer at all.
Before: leave the console
❯Looking inside a feature used to mean leaving the console
copy the worktree path into another terminalrunshep feat logs -f <id>in a window you arranged yourself
The console already showed every feature and let you approve, reject, stop and resume runs. But to look inside one, you left it. You copied the worktree path into another terminal, or ran the log command in a second window you set up yourself. Now the console opens that second view for you.
t: a shell in the worktree
opens a shell in the feature's worktree
Press t, and a shell opens in a split pane, already inside that feature's worktree. Before the worktree exists, it opens in the repository. The pane takes focus, and it inherits the console's SHEP_HOME, so any shep command you run there sees the same features. Capital T opens it in a new window or tab instead.
f: follow the agent log
follows the agent log, and focus stays on the console
shep feat logs -f <id>
F opens the log in a new window
quit with q and the panes it opened keep running
Press f, and the agent log for that feature opens on the right and keeps following. Focus stays on the console, so you can keep moving through your features. Capital F puts the log in a new window. And when you quit the console, the panes it opened keep running.
Which multiplexer gets the pane
❯Shep opens the pane in the multiplexer you are running
TMUXZELLIJWEZTERM_PANEKITTY_WINDOW_IDneeds allow_remote_control yesSHEP_MULTIPLEXER=tmux|zellij|wezterm|kitty picks one
SHEP_MULTIPLEXER=none turns panes off
Shep finds the multiplexer from its session variable, in a fixed order: tmux first, then Zellij, WezTerm and kitty. So when tmux runs inside a WezTerm window, tmux is the one that splits. kitty needs remote control turned on in its config. To choose one yourself, set SHEP_MULTIPLEXER. Set it to none, and panes are off.
No multiplexer: the console steps aside
❯With no multiplexer, the console steps aside and lends you the terminal
exit the shell, or ctrl+c the log, and the console comes back with your selection
Outside a multiplexer, t and f still work. The console steps aside and runs the shell or the log right in the same terminal. Type exit in the shell, or press control C on the log, and the console comes back, redrawn, with the feature you had selected.
/ filters the roster
narrows the roster to every word you type
name · id · repository · branch · state · phase · agent
Slash opens a filter. Every word you type has to match, across the name, id, repository, branch, state, phase and agent of each feature. Typing rate leaves just Rate Limit The Public API in the roster, while the needs you strip at the top still lists all four features. Enter keeps the filter, and escape clears it.
Alerts when a feature needs you
❯The console now alerts you when a feature starts needing you
OSC 9OSC 777OSC 99bellpassthrough + bellset allow-passthrough onshep tui --no-notify turns it offUntil now, a feature that reached a gate while you worked in another pane changed one row on screen. Now the console sends your terminal's own notification, or a bell where it has none. In tmux, set allow passthrough to on to get the notification as well as the bell. The window title also counts the features waiting on you. Alerts are on by default, and the no notify flag turns them off.
Upgrade to 1.249.0
Agents run as headless workers, so there is no live agent session to attach to. The log pane is the attach view for now.
❯Upgrade, then press t on your next feature
$ npm i -g @shepai/cli@1.249.0
kitty: allow_remote_control yes · tmux: allow-passthrough on
github.com/shep-ai/shep
One limit. Agents run as headless workers, so there is no live agent session to attach to yet. The followed log is the closest view for now. The release adds keys and one flag, and its notes list no breaking changes. Install version 1.249.0 of the shep CLI from npm, and press t on your next feature to open its shell beside the console.