Агент видит ваш проект как набор текстовых файлов. Он ищет по нему регулярками, читает файлы целиком, а когда нужно что-то переименовать - делает поиск с заменой и надеется, что не задел строку в комментарии, ключ в JSON и одноимённый метод в другом классе.
Человек с IDE так не работает. Он жмёт "переименовать символ", и среда сама находит все использования, отличает объявление от совпадения по буквам и правит ровно то, что нужно, в двадцати файлах сразу. Разница не в скорости - в надёжности: IDE понимает, что такое символ и кто на него ссылается, а поиск по тексту не понимает ничего.
Именно этот разрыв закрывает Serena. Она подключается к агенту по протоколу MCP и даёт ему инструменты уровня IDE: найти символ, показать структуру файла, найти все ссылки, заменить тело функции, переименовать. Под капотом работает языковой сервер - тот же механизм, что питает подсказки в вашем редакторе.
Подзаголовок проекта звучит соответствующе: "The IDE for Your Coding Agent". Эта статья о том, как её поставить, из чего она состоит и какие у неё есть неприятные углы.
Что такое Serena и чем она не является
Serena - набор инструментов для семантической работы с кодом, который подключается к любому MCP-клиенту. README формулирует это так: она даёт "essential semantic code retrieval, editing, refactoring and debugging tools that are akin to an IDE's capabilities, operating at the symbol level and exploiting relational structure".
Ключевые слова здесь - symbol level и relational structure. Инструмент оперирует не строками и не смещениями в файле, а символами: классами, функциями, переменными - и связями между ними.
Что Serena не делает: она не пишет код. README говорит об этом прямо - инструменты она предоставляет, а работу выполняет модель, которая эти инструменты вызывает. Serena не заменяет вашего агента и не является самостоятельным ассистентом.
Отдельно стоит запомнить предупреждение из README, набранное как важное: не ставить Serena через маркетплейсы MCP или плагинов - там лежат устаревшие и неудачные команды установки. Формулировка дословная: "Do not install Serena via an MCP or plugin marketplace! They contain outdated and suboptimal installation commands."