Vectrum
Sign In

Document the terminal drawer

The README lists the drawer among the features, its shortcuts in the
table, and its modules in the layout.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
JjohannSocommitted 1 parent 1a65586commitd301beb

Showing 1 changed file with 20 additions and 2 deletions.

+20−2README.mdView File
@@ -112,6 +112,14 @@ Gruvbox, Rosé Pine, Solarized and Dracula.
112112 its own headless Chrome session, which its agent drives with the `agent-browser` CLI
113113 while the panel shows it live. Click, scroll and type in the page yourself, or go to a
114114 URL. When the agent opens a page while the panel is closed, a light on the globe says so.
115+ - A terminal drawer under the conversation, like T3 Code's (Ctrl+J, or the panel toggle in
116+ the chat header): each thread has its own terminals, which start in the thread's folder
117+ (its worktree when it has one). Drag the drawer's top edge to resize it. Split a terminal
118+ side by side (Ctrl+D) or stacked (Ctrl+Shift+D), up to four per group, or open another
119+ (Ctrl+N while a terminal has focus); with several, a sidebar lists the groups. Close one
120+ with Ctrl+W or the trash button (after a confirmation); a terminal whose shell exits
121+ closes on its own. Right-click for Add to chat (puts the selection in the composer), Copy,
122+ Paste, Select all and Jump to latest; Ctrl+Shift+C / Ctrl+Shift+V copy and paste.
115123 - Interrupt with Esc or the stop button. Messages sent while the agent works are queued.
116124 - Crash recovery: if a process dies, the next message restarts it and resumes the session.
117125 - Threads are saved as you go and come back after a restart, settled ones included; the next
@@ -227,6 +235,10 @@ The shortcuts follow T3 Code's default keymap.
227235 | Alt+↑ | Edit the last queued message |
228236 | Ctrl+F | Find in thread |
229237 | Ctrl+B | Show or hide the sidebar |
238+ | Ctrl+J | Show or hide the terminal drawer |
239+ | Ctrl+D / Ctrl+Shift+D | Split the terminal side by side / stacked (terminal focused) |
240+ | Ctrl+N / Ctrl+W | New terminal / close the terminal (terminal focused) |
241+ | Ctrl+Shift+C / Ctrl+Shift+V | Copy / paste in the terminal |
230242 | Ctrl+Alt+B | Show or hide the right panel (the browser) |
231243 | Ctrl+Shift+B | Show or hide the thread details (project panel) |
232244 | Ctrl+O | Add a project folder |
@@ -258,6 +270,10 @@ in its `scratch` folder.
258270 - `src/models.rs`: the model catalog across providers, and favorites.
259271 - `src/git.rs`: branch and change stats, working-tree snapshots, and diffs.
260272 - `src/settings.rs`: the saved settings file, cached in memory.
273+ - `src/terminal.rs`: a shell in a pseudo-terminal, emulated by `alacritty_terminal`, and the
274+ bytes keys and pastes send to it.
275+ - `src/ui/terminal.rs`: one terminal's view: the grid in the mono font, cursor, selection,
276+ scrollback and its right-click menu.
261277 - `src/ui/chat.rs`: start screen, transcript (with turn folding), tool cards, permission bar
262278 and composer.
263279 - `src/ui/pickers.rs`: the model, reasoning and access pickers.
@@ -271,7 +287,8 @@ in its `scratch` folder.
271287 - `src/ui/workspace.rs`: window root: thread sidebar, top bar and project panel, plus the
272288 git and editor helpers behind it. Its submodules hold the sidebar (`sidebar.rs`, and the
273289 legacy layout in `sidebar/legacy.rs`), the thread menus, snoozing, confirmations and undo
274- (`actions.rs`), the chat header (`header.rs`) and the command palette (`palette.rs`).
290+ (`actions.rs`), the chat header (`header.rs`), the command palette (`palette.rs`) and the
291+ terminal drawer (`terminal_drawer.rs`).
275292 - `src/ui/icons.rs`: the extra Lucide icons the app embeds.
276293 - `src/ui/metal.rs`: the MetalUI layer. Colorway tokens and shadow recipes copied from
277294 MetalUI's CSS, the theme mapping for the stock widgets, and the primitives (caps, wells,
@@ -285,6 +302,7 @@ in its `scratch` folder.
285302
286303 There is no UI for Pi extensions that ask for free text, code blocks have no syntax
287304 highlighting, and T3 Code's project
288- scripts and terminal drawer aren't here yet. jcode models can't write thread titles (every
305+ scripts aren't here yet. The terminal drawer doesn't report mouse clicks to full-screen
306+ programs (only the wheel), open links, or show T3's popup after a selection. jcode models can't write thread titles (every
289307 jcode run is saved as a session), and jcode's side panel, applets and background-task
290308 progress aren't shown.