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

# Interests and discovery

> Manage Research Interests from the terminal.

## Research Interests

Research Interests define what you care about. They drive the recommendation engine — each interest has its own context and daily recommendation cadence.

### List Interests

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

Shows all your Research Interests with name, context preview, daily count, and active status.

```bash Text output (default) theme={null}
remyxai interests list
```

```bash JSON output theme={null}
remyxai interests list --format json
```

### Create an Interest

```bash theme={null}
remyxai interests create \
  --name "Retrieval-Augmented Generation" \
  --context "https://huggingface.co/remyxai/SpaceThinker-Qwen2.5VL-3B" \
  --daily-count 3
```

| Flag | Description | Default |
| - | - | - |
| `--name, -n` | Short label for the interest | *(prompted if omitted)* |
| `--context, -c` | Natural language description, or URLs to HuggingFace models, GitHub repos, arXiv papers | *(prompted if omitted)* |
| `--daily-count, -d` | Recommendations per day (1-10) | 2 |
| `--inactive` | Create as inactive (excluded from daily digest until toggled) | — |
| `--refresh` / `--no-refresh` | Kick a recommendations refresh after creating | `--refresh` |
| `--wait, -w` | Block until the refresh completes | — |
| `--format, -f` | Output format: `text` or `json` | `text` |

> [!TIP]
>
> Run `remyxai interests create` with no flags for an interactive prompt that walks you through each field.

### Create from a GitHub repo

```bash theme={null}
remyxai interests from-repo https://github.com/your-org/your-project
```

Builds an interest from a repo's profile (languages, topics, README, dependencies) instead of free text. Pass `--automate review` or `--automate auto` to also provision [Outrider](https://docs.remyx.ai/platform/agents/outrider-action.md) on that repo in the same step, the same flow as `outrider init`.

| Flag | Description | Default |
| - | - | - |
| `--name, -n` | Short label for the interest | *(derived from the repo)* |
| `--daily-count, -d` | Recommendations per day (1-10) | 2 |
| `--inactive` | Create as inactive | — |
| `--automate` | `none`, `review`, or `auto`. `review`/`auto` provision Outrider on the repo like `outrider init` | `none` |
| `--timeout` | Seconds to wait on Outrider provisioning when automating | 300 |
| `--refresh` / `--no-refresh` | Kick a recommendations refresh after creating | `--refresh` |
| `--wait, -w` | Block until the refresh completes | — |
| `--format, -f` | Output format: `text` or `json` | `text` |

### Create from a project's experiments

```bash theme={null}
remyxai interests from-project "My RAG Project"
```

Builds an interest from a project's experiments. The `<PROJECT>` argument accepts a project name or UUID. The interest tracks the project by default, so new experiments keep it current; pass `--no-auto-update` to take a one-time snapshot instead.

| Flag | Description | Default |
| - | - | - |
| `--name, -n` | Short label for the interest | *(derived from the project)* |
| `--daily-count, -d` | Recommendations per day (1-10) | 2 |
| `--inactive` | Create as inactive | — |
| `--include-experiment, -e` | Limit context to a specific experiment (repeatable) | *(all experiments)* |
| `--no-auto-update` | Snapshot the project once instead of tracking it | — |
| `--refresh` / `--no-refresh` | Kick a recommendations refresh after creating | `--refresh` |
| `--wait, -w` | Block until the refresh completes | — |
| `--format, -f` | Output format: `text` or `json` | `text` |

### Get Interest Details

```bash theme={null}
remyxai interests get --interest "Retrieval-Augmented Generation"
```

The `--interest` flag accepts either a **name** (case-insensitive) or a **UUID**.

### Update an Interest

```bash theme={null}
remyxai interests update \
  --interest "Retrieval-Augmented Generation" \
  --context "https://github.com/your-org/your-rag-system" \
  --daily-count 5
```

| Flag | Description |
| - | - |
| `--interest, -i` | Interest name or UUID (required) |
| `--name, -n` | New name |
| `--context, -c` | New context (invalidates recommendation pool and triggers re-ranking) |
| `--daily-count, -d` | New daily count |
| `--activate` | Set active |
| `--deactivate` | Set inactive |

> [!NOTE]
>
> Updating the `context` invalidates the pre-ranked recommendation pool. Run `remyxai papers refresh` afterward to get fresh results immediately.

### Toggle Active Status

```bash theme={null}
remyxai interests toggle --interest "Retrieval-Augmented Generation"
```

Toggles between active and inactive without deleting the interest or its recommendation history.

### Delete an Interest

```bash theme={null}
remyxai interests delete --interest "Retrieval-Augmented Generation"
```

Prompts for confirmation. Pass `--yes` to skip:

```bash theme={null}
remyxai interests delete --interest "Retrieval-Augmented Generation" --yes
```


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