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