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

# Interactive TUI

> Browse and manage your Matter library visually in the terminal.

Launch the interactive TUI by running `matter` with no arguments, or explicitly with `matter tui`:

```bash theme={null}
matter
matter tui
```

The TUI provides a visual interface for browsing your library, reading items, and managing tags -- all without leaving the terminal.

## Global shortcuts

| Key | Action |
| - | - |
| `q` | Quit |
| `Escape` | Go back |
| `/` | Open search |
| `d` | Cycle color mode (system / dark / light) |
| `j` / `Down` | Move down |
| `k` / `Up` | Move up |
| `Enter` | Select / 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.

| Key | Action |
| - | - |
| `j` / `Down` | Next item |
| `k` / `Up` | Previous item |
| `Enter` | Open item detail |
| `e` | Archive item |
| `s` | Save to queue |
| `f` | Toggle 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.

| Key | Action |
| - | - |
| `Left` / `Right` | Navigate action bar |
| `Enter` | Activate selected action |
| `s` | Save to queue |
| `e` | Archive |
| `f` | Toggle favorite |
| `n` | Toggle notebook panel (highlights and notes) |
| `w` | Open in Matter web app |
| `b` | Open original URL in browser |

## Search

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.

| Key | Input mode | Results mode |
| - | - | - |
| `Enter` | Focus results | Open item |
| `Escape` | Exit search | Back to input |
| `j` / `k` | Types normally | Navigate results |
| `Up` / `Down` | Move selection | Move selection |
| `Tab` | Cycle status filter | Cycle status filter |

### Search operators

Operators can be typed directly into the query:

| Operator | Description | Example |
| - | - | - |
| `"phrase"` | Exact phrase match | `"deep learning"` |
| `-term` | Exclude term | `-podcast` |
| `by:name` | Filter by author/publisher | `by:graham` |
| `site:domain` | Filter by domain | `site:nytimes.com` |
| `title:word` | Match in title only | `title: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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.