Istok Code — AI-агент в терминале, который пишет код вместе с вами
AI-агент в терминале: читает файлы, пишет и редактирует код, запускает тесты, объясняет архитектуру. Семь инструментов, память проекта, параллельное выполнение. Установка через npm.
Вы открываете терминал, переходите в директорию проекта и вводите одну команду: istok-code. Через секунду у вас есть AI-напарник, который знает вашу кодовую базу, умеет читать и писать файлы, запускать тесты, выполнять shell-команды — и всё это прямо из привычного терминала, без переключения в IDE или веб-интерфейс.
istok-code — это не подсказки при вводе и не автодополнение строк. Это полноценный AI-агент для разработчиков, который понимает контекст проекта, выполняет задачи и учится на ходу.
Семь инструментов в одном агенте
Read — чтение файлов проекта. Агент анализирует структуру, понимает зависимости между модулями, видит импорты и экспорты.
Write — создание новых файлов. Попросите написать миграцию базы данных, новый API-эндпоинт или конфигурационный файл — агент создаст файл в нужной директории с правильной структурой.
Edit — точечные правки в существующих файлах. Не перезапись целиком, а замена конкретного фрагмента с fuzzy-валидацией, которая подскажет, если вы промахнулись с контекстом.
Bash — выполнение shell-команд. Запуск тестов, сборка проекта, проверка статуса Git — агент выполняет команды и анализирует вывод.
Grep — поиск по содержимому файлов с regex.
Glob — поиск файлов по паттерну.
Todo — создание и управление задачами по ходу работы.
Все инструменты работают параллельно, когда это возможно. Если агенту нужно прочитать три файла для понимания задачи — он прочитает их одновременно, а не последовательно.
Контекст и адаптация
При каждом запросе агент классифицирует намерение — что вы хотите: написать код, разобраться в архитектуре, запустить тесты, настроить CI, навигировать по проекту? В зависимости от задачи подбирается оптимальная стратегия работы с инструментами.
«Объясни архитектуру модуля auth» — агент прочитает ключевые файлы, найдёт точки входа, проследит цепочку вызовов и выдаст структурированное объяснение.
«Напиши тесты для user_service» — агент изучит интерфейс сервиса, существующие тесты в проекте как образец стиля и сгенерирует тестовый файл с покрытием основных сценариев.
Память проекта
istok-code запоминает факты о вашем проекте. После каждого значимого взаимодействия система автоматически извлекает и сохраняет ключевые факты: используемый стек, структура проекта, паттерны кодирования, конвенции именования. Всё хранится локально в ~/.istok/projects/…/memory.json.
Команда /memory позволяет просматривать, добавлять и удалять факты вручную. Когда вы возвращаетесь к проекту через неделю — агент помнит, что здесь FastAPI с SQLAlchemy, тесты на pytest, деплой через Docker Compose.
Восстановление и надёжность
Сессия восстанавливается автоматически при повторном открытии терминала в той же директории — до 24 часов после последнего взаимодействия. Если агент упал посреди сложной задачи — checkpoint per tool call позволяет продолжить с последнего успешного шага.
ESC мгновенно останавливает генерацию. Вставка многострочного кода через буфер обмена не вызывает случайную отправку — работает bracketed paste mode.
MCP-интеграции
Через конфигурационный файл ~/.istok/mcp.json можно подключить внешние MCP-серверы — расширить набор инструментов агента произвольными API, базами данных, внутренними сервисами. Команда /mcp управляет подключёнными серверами прямо из терминала.
Бенчмарки
На бенчмарке PASS@1 istok-code показывает результат 78 — между Qwen 3 Coder (76) и DeepSeek V3 (85). GPT-5 — 89, Codex — 72. Для агента, работающего в терминале с полным доступом к проекту, это конкурентный результат: агент компенсирует разницу за счёт контекста проекта и инструментов.
Как начать
Авторизация: istok auth
Запуск: istok в директории проекта.
Разговаривайте с кодовой базой на русском. Полная прозрачность токенов — после каждого ответа видите стоимость в input/output.