Аутентификация вынесена отдельно - и это не мелочь оформления, а граница безопасности. Обычно агент логинят его собственной командой /login уже внутри сессии, либо задают переменные окружения - через кнопку "..." на вкладке Agents или ключом devin.acp.agentEnv.<agentName> в settings.json. Registry описывает запуск, а не секреты, и в этом разделении есть смысл: конфиг запуска и хранилище доступов живут по разным правилам и меняются в разном темпе.

Держать токен прямо в registry.json документация напрямую не требует и не запрещает, но инженерно это плохое место, и вывод здесь важнее буквы. Файл описывает запуск, часто попадает в дотфайлы и в синхронизацию между машинами, и секрет в нём утекает вместе с конфигом, незаметно и надолго. Поэтому доступы держат в окружении или в /login, где у них своя политика жизни и своя область видимости, а registry оставляют чистой декларацией запуска. Это вывод из устройства, а не пункт продукта, но цена ошибки здесь измеряется не строкой в логе, а утёкшим токеном.

Локальный registry оправдан, когда сторонний агент действительно нужен в вашей экосистеме и бинарник у вас уже есть или ставится штатным способом. Он не заменяет установку, не следит за версиями и не чинит зависимости - это тонкий слой, который лишь объясняет Desktop, как позвать то, что уже стоит. Ждать от него большего значит требовать функций магазина от карты запуска и потом удивляться их отсутствию.

Проверять результат стоит не по факту "запись добавлена", а по короткой цепочке из трёх шагов. Откройте файл командой из палитры и убедитесь, что путь к бинарнику и аргументы верны именно для вашей ОС, а не для соседней. Проверьте, что executable реально существует и запускается руками из терминала - если он не стартует сам, Desktop его тоже не поднимет. Включите агент на вкладке Agents и перезапустите Desktop. И только потом ждите его в selector: если не появился, вопрос почти всегда в одном из этих трёх шагов, а не в самом протоколе ACP.

Типичные провалы предсказуемы и почти всегда сводятся к подмене модели. "Агент не скачался" - потому что Desktop и не качает, бинарник ставят отдельно. "Запись есть, а агента нет" - не включили на вкладке Agents или не перезапустили. "Логин не проходит" - токен положили в registry вместо окружения или /login. "Файл не там" - искали по имени Devin, а путь остался .windsurf. Признак один во всех случаях: registry приняли за магазин, а не за карту запуска уже установленного бинарника. Вернуть ему эту роль - и большинство "почему не работает" отвечают себе сами ещё до обращения в поддержку.