How-tos
Use the button bar
The button bar is a row of one-click macro buttons below the terminal. Each button sends a string you define — a command plus Enter, a control code, a timed sequence — to the active session. It is off by default and starts empty until you map your first button.
Buttons send keystrokes exactly as if you typed them: straight down the PTY as human input. A button press does not go through the AI agent and is not policy-gated — the per-vendor command gate only ever applies to commands the AI proposes. A button you press is just you, typing fast.
Show or hide the bar
Toggle it from the menu bar: View → Button Bar (a checkmark shows when it is on). You can also right-click the bar itself and choose Hide button bar. The setting is remembered between launches.
Map a button
- With the bar showing, click + New button… (or right-click empty space on the bar → New button…).
- In the Map Button dialog, leave Function on Send String.
- Type a Label — the text shown on the button (e.g.
show ver). - Type the String to send (e.g.
show version\r). The escape codes are listed right under the field. - Click OK. The new button appears at the end of the bar.
To change a button later, right-click it → Edit…; to remove it, right-click → Delete. Buttons are global — the same bar shows for every session, and a press always goes to whichever tab is in front. (If the front tab’s session has ended, the press is ignored.)
Escape codes
The String field is literal text plus these escape codes:
| Code | Sends |
|---|---|
\r | Carriage return — Enter (submit a command) |
\n | Line feed (newline) |
\e | Escape (0x1B) — the start of an ANSI sequence |
\p | A one-second pause before the next characters |
\v | The current clipboard contents (paste) |
\\ | A literal backslash |
\### | A raw byte from one to three octal digits (e.g. \003 = Ctrl-C, \033 = Escape) |
Anything else after a backslash is sent as the plain character.
Examples
| Goal | String |
|---|---|
| Run a command and submit it | show version\r |
| Send Ctrl-C to interrupt | \003 |
| Enter enable mode, wait, then send a password | enable\r\ppassword\r |
| Paste the clipboard, then press Enter | \v\r |
| Move the cursor up (ANSI) | \e[A |
Unlike a Cmd/Ctrl-V paste, a \v in a button sends the clipboard
straight through — it does not go through the multi-line paste
confirmation, because you authored the
macro yourself.
Limits
A label can be up to 48 characters and a string up to 1024, and you can map up to 50 buttons. Buttons can’t be reordered yet — new ones append to the end of the bar.