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

​
Global shortcuts

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

​
Search operators

Operators can be typed directly into the query:

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