Skip to main content
Launch the interactive TUI by running matter with no arguments: 
matter
The TUI provides a visual interface for browsing your library, reading items, and managing tags — all without leaving the terminal.

​
Global shortcuts

KeyAction
qQuit
EscapeGo back
/Open search
dCycle color mode (system / dark / light)
j / DownMove down
k / UpMove up
EnterSelect / confirm

​
Command palette

The landing screen. Arrow keys to navigate, Enter to select. Available commands: Search, Browse Inbox, Browse Queue, Browse Archive, Browse All Items, Settings.

​
Item list

Browse items in a list with status, progress, and site info.
KeyAction
j / DownNext item
k / UpPrevious item
EnterOpen item detail
eArchive item
sSave to queue
fToggle favorite
Scrolling near the bottom auto-loads the next page.

​
Item detail

View article content with a sidebar showing metadata (author, status, type, progress, tags). Articles render as markdown in the terminal.
KeyAction
Left / RightNavigate action bar
EnterActivate selected action
sSave to queue
eArchive
fToggle favorite
nToggle notebook panel (highlights and notes)
wOpen in Matter web app
bOpen original URL in browser
Type to search — results update automatically after a short delay (minimum 2 characters). Press Enter to focus results, then j/k to navigate and Enter to open. Escape returns to the search input (or exits search if already in input mode). Typing any character while browsing results returns to the input.
KeyInput modeResults mode
EnterFocus resultsOpen item
EscapeExit searchBack to input
j / kTypes normallyNavigate results
Up / DownMove selectionMove selection
TabCycle status filterCycle status filter

​
Search operators

Operators can be typed directly into the query:
OperatorDescriptionExample
"phrase"Exact phrase match"deep learning"
-termExclude term-podcast
by:nameFilter by author/publisherby:graham
site:domainFilter by domainsite:nytimes.com
title:wordMatch in title onlytitle:review

​
Settings

Toggle options with Enter:
  • Readonly Mode — prevent write operations
  • Color Mode — system, dark, or light
  • Auth Token — shows a preview of your stored token
  • Version — current CLI version

​
Configuration

TUI settings are stored alongside CLI config at ~/.config/matter/config.json. You can also toggle settings directly in the TUI’s settings screen.