Use the terminal interface

Start the terminal interface:

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:

/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.

Get started

Work with sessions

Manage project knowledge

Configuration

Connect agents

Reference

Use the terminal interface

Session list

Command box

Session details

Import sessions

Keyboard reference

​Session list

​Command box

​Session details

​Import sessions

​Keyboard reference

Session list

Command box

Session details

Import sessions

Keyboard reference