Skip to content
Docs0.9GitHubInstall

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.

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

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.

Press ? outside a text box to see every shortcut. Change shortcuts at the bottom of that list opens Settings → 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.

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.

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.

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

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 chooser and the terminal overview have their own keys, set in [tui.keys]. See The chooser and Configuration.