# @ упоминания

Источник: https://docs.kodik.ru/context/mentions

@ Упоминания позволяют напрямую включать файлы, папки и вывод терминала в контекст разговора, не прибегая к копированию и вставке.

![Image](https://docs.kodik.ru/img/image28.png)

Введите `@` в поле чата — появится меню доступных типов упоминаний.

## Типы упоминаний

### Файлы

Синтаксис: `@/путь/к/файлу` или `@"/путь с пробелами/файл.ts"`

Kodik включит полное содержимое файла в контекст. Пути указываются относительно корня рабочего пространства.

### Папки

Синтаксис: `@/путь/к/папке`

Kodik включит список файлов в папке. Папочные упоминания обрабатываются отдельно от файловых (внутренний тег `@folder:`): при клике в панели проводника открывается папка, а не файл.

### Диапазоны строк

К файловому упоминанию можно добавить диапазон строк:

- Одна строка: `@/src/index.ts#L42`
- Диапазон строк: `@/src/index.ts#L10-L50`

Суффикс `#L...` указывает агенту, какая часть файла наиболее релевантна, и используется при навигации (файл открывается на нужной строке).

### Терминал

Синтаксис: `@terminal:<имя терминала>`

Прикрепляет вывод активного терминала с указанным именем. Kodik получает до **200 последних строк** из буфера терминала. Если терминал с таким именем не найден или буфер пуст, это явно указывается в контексте.

Пример: `@terminal:bash`, `@terminal:npm run dev`

![Image](https://docs.kodik.ru/img/image35.png)

## Как используются упоминания

При отправке сообщения Kodik обрабатывает все упоминания и формирует раздел `<user_mentions>` в контексте. Файловые и папочные упоминания передаются с путями относительно рабочего пространства. Файлы, заблокированные через [`.kodikignore`](https://docs.kodik.ru/context/ignore-files), не попадают в контекст.

Терминальные упоминания передаются в отдельном разделе `<terminal_context>` и не смешиваются с файловыми.

## Примеры использования

```
Я получаю ошибку в @/src/api/users.ts#L34-L56

Вот конфигурация: @/vite.config.ts

Вывод сборки: @terminal:npm run build
```

```
Проверь всю структуру: @/src/components
```

## Начало работы

1. Введите `@` в поле чата.
2. Выберите тип упоминания из меню или продолжайте вводить путь.
3. Отправьте сообщение как обычно.

Kodik автоматически обработает упоминания и включит указанный контент перед вызовом модели.