Legends Code CLI

AI-агент прямо в терминале. Читает и правит файлы, скачивает из интернета, ищет по коду, выполняет команды — на русском языке.

Установка

npm install -g @legends_code/legends-cli

Нужен Node.js 18+.

Вход

Ключ создаётся в приложении Legends Code: Настройки → «⚡ Legends Code CLI» → Мои ключи

legends login lgs_cli_ваш_ключ

Использование

legends                    # интерактивный режим
legends "задача"           # выполнить одну задачу и выйти
legends --help             # справка

Что умеет

| Возможность | Описание | |---|---| | Чтение файлов | целиком или частями, с номерами строк | | Правка файлов | точечная замена фрагмента, без перезаписи всего файла | | Создание файлов | новые файлы и папки | | Удаление / перемещение / копирование | с подтверждением и откатом через /undo | | Массовая замена | заменить текст сразу в нескольких файлах по маске, с предпросмотром (dry run) | | Скачивание | файлы из интернета по ссылке на твой компьютер | | Чтение веб-страниц | текст страницы или API-ответа без сохранения на диск | | Дерево папки | структура проекта рекурсивно, одним выводом | | Поиск файлов | по имени/маске рекурсивно | | Поиск по коду | найти где определена функция или встречается текст | | git diff | незакоммиченные изменения без обрезки вывода | | Терминал | выполнить команду и разобрать вывод |

Файл .legendsignore в корне папки (по одной маске на строку, как .gitignore) — поиск, дерево папки и массовая замена будут его учитывать.

Команды в интерактивном режиме

| Команда | Действие | |---|---| | /help | список команд | | /tools | что агент умеет | | /tips | примеры удачных запросов | | /cwd | текущая папка | | /cd <путь> | сменить рабочую папку (Tab — автодополнение папок) | | /login | добавить профиль | | /model | переключить профиль | | /logout | удалить все профили | | /theme | сменить цветовую тему | | /save [файл] | экспортировать диалог в markdown | | /resume | восстановить последнюю сессию | | /diff | список изменений файлов за сессию | | /undo | откатить последнее изменение файла | | /doctor | проверить окружение (Node, git, сеть, профиль) | | /clear | очистить историю сессии | | /exit | выйти |

Безопасность

Перед изменением, удалением, перемещением, копированием файлов, массовой заменой, скачиванием и запуском разрушительных команд (rm -rf, Remove-Item, git reset --hard, sudo и т.п.) агент спрашивает подтверждение — одним вопросом на всю пачку действий.

Безопасные операции (чтение, поиск, дерево папки, git diff, ls) выполняются сразу без вопросов.

Команда /undo откатывает последнее изменение файла (запись, правку, удаление, перемещение, массовую замену). Работает только в рамках текущего запуска CLI — история отмены не сохраняется на диск и очищается при выходе или /clear.

Примеры

❯ разберись что за проект в этой папке
❯ скачай https://example.com/archive.zip ко мне в загрузки
❯ найди все TODO в проекте и собери в один файл
❯ почини ошибку в src/app.js — падает на старте
❯ покажи дерево этого проекта без node_modules
❯ замени во всех .js файлах старый импорт на новый
❯ покажи git diff и объясни что изменилось

Где хранятся ключи

~/.legends/config.json — поддерживается несколько именованных профилей.