Using itSearch and keyboard
Search and keyboard
Find a message in a chat or across chats, and drive the web client from the keyboard with jump mode and rebindable shortcuts.
How to find things in the apps, and how to use the web client without the mouse, for anyone who uses them daily. Search works the same in the web client and the iPhone app; the keyboard section is for the web client.
Search in a chat
Section titled “Search in a chat”Pick Search in chat from the chat’s menu. In the web client in Advanced there is also a button in the chat’s header.
- Type at least two characters. Case and accents are ignored.
- The count reads “2 of 7”, and the newest match is selected first.
- It searches the messages the chat has loaded. In the web client, Show earlier messages loads more to search.
- Folded in-between responses open while you search.
| Web client | iPhone | |
|---|---|---|
| Older match | Enter, or Older match | Earlier match |
| Newer match | ShiftEnter, or Newer match | Later match, or Return |
| Close | Esc, or Close search | Done |
Search across chats
Section titled “Search across chats”Use the search field above the chat list. In the web client, CtrlShiftK goes to it (CmdShiftK on a Mac).
| Scope | Finds |
|---|---|
| Titles | Chats and projects by name. Each new search starts here. |
| Messages | Message text and voice-note transcripts, newest first, up to 50 |
| All | Both |
- Message search needs two characters and runs when you pause typing.
- Exited conversations that match by title or project show under Exited.
- A result opens its chat. It opens at the chat’s end, so use search in the chat to reach the message.
- In the web client, Enter opens the top result, ↓ moves into the list, and Esc clears.
Search runs on the device, over the messages that device holds. Nothing is sent to the computer to search, and a device that has loaded less of a chat finds less.
In Simple the scopes are hidden and search finds chats and projects by name.
The web client’s keyboard
Section titled “The web client’s keyboard”Press ? outside a text box to see every shortcut. Change shortcuts at the bottom of that list opens Settings → Shortcuts.
Shortcuts
Section titled “Shortcuts”| Key | Does |
|---|---|
| AltG | Jump mode: a key on everything |
| CtrlK | Jump to a chat by a few letters of its name or project |
| CtrlShiftK | Search chats |
| Alt↓ / Alt↑ | Next chat / previous chat |
| AltI | Go to the message box |
| AltR | Mark the chat as read |
| ShiftEnter | Send the message, from anywhere but a text box |
| Esc | Close the chat |
| ? | Keyboard shortcuts |
On a Mac, Ctrl in this table is Cmd.
Keys without Ctrl, Alt, or Cmd wait while you type in a box, and an open dialog or menu takes the keyboard first.
Jump mode
Section titled “Jump mode”Screens, chats, and buttons have no keys of their own. In jump modeJump mode. In the web client, a key that puts a letter on every screen, chat, and button, so you can go there from the keyboard., AltG, from a text box too, puts a label on each: press it to go there.
These letters never change:
| Key | Goes to | Key | Goes to |
|---|---|---|---|
| O | Overview | N | New agent |
| C | Calendar | A | Mark all as read |
| T | Tasks | V | Talk to Master |
| R | Schedules | X | Select agents |
| H | History | L | Chats |
| S | Settings | U | Tree layout |
| M | Master | P | Projects layout |
- Projects and chats in the sidebar take the letters left, in list order, home row first, and two letters each once those run out.
- The open screen’s buttons take digits.
- A plugin’s screen takes the first free letter of its name and keeps it.
- Esc, or any key without a label, cancels and leaves the caret where it was.
With Show shortcut hints on in Settings → Shortcuts, the sidebar shows the letters all the time, on a computer with a keyboard and a mouse.
In the message box
Section titled “In the message box”| Key | Does |
|---|---|
| Enter | Send |
| ShiftEnter | New line |
| CtrlEnter | Add to the queue |
| Esc | Leave the message box |
| CtrlB, I, E | Bold, italic, code |
| CtrlK | Link the selected text. With nothing selected, it jumps to a chat. |
| CtrlShiftX | Strikethrough |
These are fixed. In the full-screen editor Enter is a new line and CtrlEnter sends. With a mouse or trackpad, opening a chat puts the caret in its message box unless you are typing somewhere else.
On the overview
Section titled “On the overview”| Key | Does |
|---|---|
| ← / → | Move between lanes |
| ↑ / ↓ | Move between cards |
| Enter | Open the chat |
| / | Search |
| 1–3 | Pick an option of the question in focus |
| A / D | Approve / deny |
Rebind a shortcut
Section titled “Rebind a shortcut”Settings → Shortcuts lists every action in the first table.
| Button | Does |
|---|---|
| Change | Records the next keys you press. Esc cancels. |
| Clear | Leaves the action without a key |
| Reset | Puts the action’s default back |
| Reset all | Puts every default back |
It warns when a key is already another action’s (only the one listed first runs), or when the browser uses it. Keys the browser never gives a page, such as the ones that open or close a tab, are refused.
Your bindings are kept in that browser. Another browser, or another device, has its own.
The terminal’s keys
Section titled “The terminal’s keys”The chooser and the terminal overview have their own keys, set in [tui.keys]. See The chooser and Configuration.