Beyond one window
Sessions in a terminal
An agent started by hand in a folder no editor has open, and how the click finds its tab.
Off by default. Turn on Show sessions started in a terminal, in Settings › Panel, or run lampboard terminal on.
With it on, every agent started by hand in a folder that no editor window has open gets a row: Terminal, iTerm2, Ghostty, a tmux or zellij pane. The row is named by its conversation title and carries a small terminal glyph.
It exists only while the agent's session file is live, and turning the switch off takes those rows away at once.
Where the row is anchored
On the folder the session started in, taken from the session file rather than from the hook. The hook's folder follows every directory change the agent makes; the session file's does not.
How the click finds the tab
Through the session's process, never by guessing a window title.
| Where it runs | How the tab is found | What it needs |
|---|---|---|
| Terminal.app | by tty, through Terminal's dictionary | Automation for Terminal, asked once |
| iTerm2 | by tty, through iTerm2's dictionary | Automation for iTerm2, asked once |
| Ghostty | by conversation title or folder; when those name more than one surface, by writing a marker title to the session's tty and asking which surface carries it | Automation for Ghostty, asked once |
| WezTerm | by tty, through wezterm cli | nothing |
| kitty | by pid, over kitty's remote-control socket | allow_remote_control yes and listen_on unix:/tmp/kitty in kitty.conf |
| tmux pane | the pane is selected inside tmux, then the attached client's tab as above | nothing |
| zellij pane | the client is paired with its server, then its tab as above; the pane inside zellij is yours to find | nothing |
Without kitty's two configuration lines the click activates kitty and the menu says why.
Two limits, stated
An agent running in a terminal tab inside a folder that is open in VS Code is an editor row like any other. Same project, same window, and the click raises the VS Code window.
An agent started from a shell that another agent session opened writes no session file, so it gets no row.
Renaming
Terminal rows rename like any other, with Rename… in the row's menu or with lampboard rename <folder> [name]. The name is what the panel shows, by folder, and nothing else changes.