Полный рабочий маршрут в CLI

У Istok Code есть несколько корректных сценариев запуска, и их полезно различать с самого начала. Команда istok-code открывает полноценную интерактивную сессию. Команда istok-code "сделай X" подходит, когда нужен один стартовый запрос без ручного ввода после запуска. Режим --pipe нужен для одноразового чтения stdin, а --file и --system помогают добавить в контекст файл или системную инструкцию без ручного копирования.

Для первой проверки контура не начинайте сразу с правок. Сначала выполните istok-code --check. Эта команда не решает рабочую задачу, зато быстро показывает, доступен ли сервис, есть ли авторизация и видит ли CLI модель и квоту. После этого уже переходите к реальному запросу.

Лучший первый цикл в Istok Code это не абстрактное приветствие, а короткая задача по знакомому участку репозитория. Например, попросите объяснить функцию, найти возможный баг или описать, как устроен конкретный модуль. Так вы одновременно проверяете качество ответа, контекст проекта и поведение инструментов.

После первого реального ответа имеет смысл сразу посмотреть usage. Это можно сделать командой istok-code usage в отдельном вызове или /usage внутри интерактивной сессии. Тогда вы сразу видите, что запрос действительно прошёл рабочий контур, а не остался локальным экспериментом без учёта квоты.

В интерактивной сессии важно не только то, что агент пишет, но и как вы управляете самой оболочкой. Подтверждение инструментов идёт через y для одобрения, n с причиной для отклонения и show для просмотра деталей вызова. Это основной контур безопасности, когда агент хочет читать, менять файлы или запускать команды.

Лог сессии не привязан навсегда к нижнему краю терминала. Если вывод ушёл вверх, используйте PgUp и PgDn для постраничного просмотра, Home для перехода в начало истории и End для возврата вниз. Это особенно важно во время длинных verify и bash-команд, когда нужно посмотреть старые сообщения без потери текущего контекста.

CLI хранит локальные записи сессий и умеет поднимать их снова. Для быстрого просмотра используйте --sessions при запуске или команду /sessions [limit] внутри интерактивной сессии. Для продолжения используйте istok-code --resume <id|latest>. Это удобно, когда вы прерываете долгую задачу и хотите вернуться именно к тому же локальному контексту.

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

Практически здоровый ритм работы с Istok Code выглядит так: короткая формулировка задачи, чтение кода, точечные изменения, проверка через verify и только потом следующая итерация. Это работает лучше, чем просить агента сразу переписать половину проекта одним сообщением.

Если проверка упала, не начинайте новый длинный диалог с нуля. Сначала используйте /fix после неуспешного verify или откройте статью про project context и verify. В этом режиме агент получает контекст последнего падения и работает заметно точнее.

Кроме базовых опций CLI поддерживает несколько флагов для специфических сценариев. Флаг --sandbox ограничивает Bash через ulimit — полезно, когда нужно добавить барьер перед командами, которые могут потреблять много ресурсов или менять файловую систему за пределами проекта.

Флаг --auto-stash автоматически делает git stash перед запуском сессии, чтобы незафиксированные изменения не смешивались с тем, что делает агент. Это особенно важно при работе на dirty рабочем дереве. Флаг --add-dir добавляет директорию в индекс проекта, если нужна область за пределами текущего корня. Для CI и автоматизированных пайплайнов используйте --output-format json, который переключает вывод в stream-json.

CLI хранит локальную историю сессий только на той машине, где запускался. Если вы переключились между ноутбуком и сервером — --resume не найдёт сессии с другого окружения.

Поддержка Windows — только через WSL. Нативный Windows без WSL не поддерживается. ThinkTagFilter (фильтрация внутренних рассуждений `<think>...</think>` у моделей типа DeepSeek и Qwen) работает автоматически, но при использовании моделей без блоков мышления он просто не срабатывает.

MCP-серверы можно подключать, но конфигурация требует ручной настройки. Готовых MCP-инструментов в продукте нет — это возможность для опытных пользователей.