> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gethandshake.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Use the terminal interface

> Browse, search, import, inspect, and restore sessions in the Handshake terminal interface.

Start the terminal interface:

```bash theme={null}
handshake browse
```

You can also run `handshake b` or `handshake ui`.

## Session list

The main view shows one card for each stored session. A card can show the
title, source agent, update time, project, and working directory.

Use the arrow keys to move through the list. Press Enter to open a session.

## Command box

Enter text without a leading slash to search stored messages.

Use a slash command for a specific action:

| Command           | Function                                          |
| ----------------- | ------------------------------------------------- |
| `/open`           | Opens the selected session.                       |
| `/timeline`       | Opens the selected session timeline.              |
| `/search <query>` | Searches all stored sessions.                     |
| `/pull [agent]`   | Imports sessions from native agent storage.       |
| `/brief`          | Opens the handoff brief for the selected session. |
| `/agent [name]`   | Sets or cycles the source-agent filter.           |
| `/help`           | Shows available commands and keys.                |
| `/quit`           | Exits the interface.                              |

## Session details

The detail view can show:

* Session metadata.
* Conversation timeline.
* Related commits.
* Handoff brief.
* Restore action.

## Import sessions

Press `s` or run:

```text theme={null}
/pull
```

Handshake reports imported, updated, unchanged, and failed session counts.
Warnings do not remove successfully imported sessions.

## Keyboard reference

| Key        | Function                                                 |
| ---------- | -------------------------------------------------------- |
| Up or Down | Moves between sessions or items.                         |
| Enter      | Opens the selected item.                                 |
| `s`        | Imports sessions.                                        |
| `t`        | Opens the session timeline.                              |
| `y`        | Opens the restore confirmation for the selected session. |
| `h` or `?` | Opens help.                                              |
| Esc        | Returns to the previous view.                            |
| `q`        | Exits the interface.                                     |