Yenisei CLIВозможности

Возможности

Что помощник умеет делать в проекте, как показывает правки и когда спрашивает разрешение.

Помощник читает и правит код, запускает команды и тесты, читает документы и сохраняет каждую свою правку в git. На этой странице описано, что именно он делает на каждом шаге и в каких случаях останавливается, чтобы спросить вас.

Карта проекта и поиск

Помощник строит карту файлов с функциями и классами и ищет по коду. Карту показывает команда /map.

Правка файлов

Каждую правку помощник показывает строками - и + со счётчиком изменённых строк. Если в файле окончания строк Windows, правка их сохраняет.

Две правки в main.py и коммит после задачи

Разрешения на файлы

• Перед удалением файла помощник спрашивает разрешение.
• Доступ к файлам вне рабочей папки он тоже спрашивает — один раз на каждый путь.
• Если вы ответили «нет», этот файл до конца задачи не тронет ни одна команда.

Запуск команд

Помощник запускает команды сам, но перед некоторыми спрашивает разрешение.

• Команды для просмотра выполняются сразу: ls, cat, grep, git status, git diff, git log, на Windows — dir, type.
• Остальные команды ждут вашего ответа на вопрос «? выполнить: … [y/N]».
• Опасные команды помощник спрашивает всегда, даже в авто-режиме, и помечает предупреждением «⚠ опасная команда». Это rm, mv, curl, sudo, kill, git push, git reset, git clean, на Windows — del, rd, format и подобные.
• Строка проверяется целиком: ls && rm файл считается опасной.
• Одной команде отводится до 3 минут.

Перед обычной командой помощник спрашивает разрешение

Опасную команду помощник спрашивает всегда

Фоновые процессы

Сервер разработки или сборку помощник запускает в фоне, а журнал пишет в папку .yenisei-bg/ внутри проекта. При выходе он останавливает всё, что запустил.

Сохранение правок в git

• После каждой задачи изменённые файлы сохраняются коммитом yenisei: <задача>. В коммит попадают только файлы, которые менял помощник.
• Команда /diff показывает, какие файлы изменены и ещё не сохранены коммитом.
• Команда /undo откатывает последний коммит помощника. Чужой коммит он не тронет.

Откат последней правки командой /undo

Если в папке нет git, помощник работает, но правки не сохраняет и откатить их не может — см. Частые вопросы.

Документы

Помощник читает PDF, Word, Excel и PowerPoint. Подробнее — на странице Работа с файлами и документами.

Авто-режим

Авто-режим включается ключом -y при запуске (yenisei -y) или командой /auto в переписке. В нём помощник не спрашивает разрешения на обычные команды, на удаление файлов и на доступ вне рабочей папки.