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

# Recommendations and search

> Daily recommendations, refreshes, and search across papers, repos, models, and datasets.

## Recommendations

Get personalized resource recommendations based on your Research Interests.

### Daily Digest

```bash theme={null}
remyxai papers digest
```

Shows today's top recommendations grouped by Research Interest. Each entry includes the resource title, source type, relevance score, and why it was recommended.

| Flag | Description | Default |
| - | - | - |
| `--limit, -n` | Max items per interest | 5 |
| `--period, -p` | `today`, `week`, or `all` | `today` |
| `--format, -f` | `text` or `json` | `text` |
| `--full` | Show full reasoning text without truncation | — |

```bash Today's digest theme={null}
remyxai papers digest
```

```bash This week, JSON output theme={null}
remyxai papers digest --period week --format json
```

```bash Full reasoning, 3 per interest theme={null}
remyxai papers digest --full --limit 3
```

### List Recommendations

```bash theme={null}
remyxai papers list
```

Flat list of all recommendations (not grouped by interest). Supports more granular filtering.

| Flag | Description | Default |
| - | - | - |
| `--interest, -i` | Filter by interest name or UUID | *(all interests)* |
| `--limit, -n` | Max results (1-50) | 20 |
| `--period, -p` | `today`, `week`, or `all` | `all` |
| `--source-type, -s` | Filter by source type (`arxiv_paper`, `github_repo`, etc.) | *(all types)* |
| `--format, -f` | `text` or `json` | `text` |
| `--full` | Show full reasoning text | — |

```bash theme={null}
# Papers for a specific interest from this week
remyxai papers list --interest "Retrieval-Augmented Generation" --period week

# Only GitHub repos
remyxai papers list --source-type github_repo
```

### Refresh Recommendations

```bash theme={null}
remyxai papers refresh
```

Triggers an async recommendation refresh. By default, refreshes all active interests. Use `--wait` to block until complete.

| Flag | Description | Default |
| - | - | - |
| `--interest, -i` | Refresh a specific interest (name or UUID) | *(all active)* |
| `--num-results, -n` | Items per interest | *(uses interest's daily\_count)* |
| `--wait, -w` | Block until all tasks complete | — |
| `--format, -f` | `text` or `json` | `text` |

```bash Refresh all, wait for results theme={null}
remyxai papers refresh --wait
```

```bash Refresh one interest theme={null}
remyxai papers refresh --interest "Reinforcement Learning" --wait
```

### Check Refresh Status

```bash theme={null}
remyxai papers refresh-status <task_id>
```

Poll the status of an async refresh task (from `papers refresh` without `--wait`).

## Search

Search across the Remyx resource index — papers, repos, models, and datasets with Docker availability filtering.

### Query

```bash theme={null}
remyxai search query "retrieval augmented generation for code"
```

| Flag | Description | Default |
| - | - | - |
| `--max-results, -n` | Maximum results | 10 |
| `--category, -c` | Filter by category (can be specified multiple times) | *(all)* |
| `--docker` | Only show resources with runnable Docker environments | — |
| `--no-docker` | Only show resources without Docker | — |

```bash theme={null}
# Search for Docker-ready resources only
remyxai search query "vision language models" --docker --max-results 5

# Filter by category
remyxai search query "reinforcement learning" --category cs.LG --category cs.AI
```

### Get Resource Details

```bash theme={null}
remyxai search info 2308.12345
```

Returns detailed information for a specific resource by arXiv ID, including full abstract, Docker status, Dockerfile contents, and reference summary.

| Flag | Description | Default |
| - | - | - |
| `--format, -f` | `text` or `json` | `text` |

### List Recent Resources

```bash theme={null}
remyxai search list
```

Browse recently added resources with pagination.

| Flag | Description | Default |
| - | - | - |
| `--limit, -n` | Number of results | 20 |
| `--offset, -o` | Pagination offset | 0 |
| `--category, -c` | Filter by category (multiple allowed) | *(all)* |
| `--docker` / `--no-docker` | Filter by Docker availability | *(all)* |

### Catalog Statistics

```bash theme={null}
remyxai search stats
```

Shows aggregate stats: total assets, Docker availability counts, category breakdown, and citation classification coverage.


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