РазумДокументация
Агенты

Проекты и папки

Агент работает в папке проекта — с кодом, документами или в чате «Без папки».

«Без папки»

Чат для задач без кода: разобрать документы, подготовить отчёт, сгенерировать картинку. Он доступен сразу после установки. У каждого такого чата своя папка — ~/Razum/NoFolder/<id чата>: там лежат файлы, которые создаёт агент, и её же показывает панель «Файлы» этого чата. Агенты, которых запустил чат, работают в той же папке. Удалите чат — его папка уйдёт вместе с ним. В боковой панели такие чаты собраны в группу «Без папки». Где лежит ~/Razum и как её перенести — Папка данных.

Выбрать папку

В новом чате нажмите на имя папки под полем ввода. В меню первым идёт «Без папки», за ним — все папки, которые вы открывали, и «Открыть папку…», чтобы выбрать новую. Подойдёт любая папка: репозиторий с кодом, папка с документами, выгрузка из 1С.

У начатого чата проект стоит в шапке, справа от названия чата. Его меню — git-ветка, дополнительные папки, «Показать в Finder», «Открыть на GitHub», «Копировать» (путь или имя ветки) и «Открыть в терминале». Папку начатого чата сменить нельзя: для другой папки начните новый чат.

Убрать проект из боковой панели — «Убрать из сайдбара» в его меню; файлы при этом не трогаются, а папка остаётся в меню под полем ввода. Выберите её там — и она вернётся в боковую панель.

Дополнительные папки

Если задаче нужны файлы из нескольких мест — например, фронтенд и бэкенд в разных репозиториях, — добавьте папки: «Добавить папку» в меню «+» поля ввода или «Добавить папку…» в меню проекта. Добавленные папки перечислены в меню проекта, в «Дополнительные папки», там же их можно убрать. Агент читает и правит файлы и там. Правила и git-статус относятся к основной папке; в дополнительной агент сам прочитает её AGENTS.md, если он есть.

Что агент узнаёт о проекте сам

  • AGENTS.md в корне — правила проекта: как собирать, тестировать, какой стиль кода. Вложенные AGENTS.md в подпапках агент читает, когда работает с файлами там.
  • Правила и навыки проекта — из папки .razum/. → Правила, Навыки
  • Подключения проекта — из .razum/mcp.json. → Подключения

Файлы проекта, которые запускают программы

Если в проекте есть настройки, которые запускают программы на компьютере (например, подключения в .razum/mcp.json), «Разум» не выполнит их, пока вы не нажмёте «Доверять». После любого изменения такого файла он спросит снова.

Git-ветки

Под полем ввода видна текущая ветка. Из списка можно переключиться на другую или создать новую — «Создать ветку». Если в рабочей копии есть незакоммиченные изменения, «Разум» предложит, что с ними сделать: перенести на новую ветку, спрятать в stash, закоммитить или отменить.

На странице