Повседневные команды, модели и сессии
Справочник по основным командам Istok Code: модели, usage, billing, конфигурация, история локальных сессий и продолжение работы без ручной путаницы.
- CLI уже работает, но хочется иметь короткую карту команд под рукой
- Нужно быстро переключать модель, читать usage или менять локальную конфигурацию
- Команда растёт и нужен понятный reference без лишней внутренней кухни
- Понимание, какие команды относятся к аккаунту, а какие к текущей локальной сессии
- Уверенная работа с model picker, usage, billing, config и resume
- Меньше хаоса между локальными и серверными состояниями
Команды аккаунта и состояния доступа
Для входа и проверки авторизации используйте istok-code login, istok-code login --device, istok-code status и istok-code logout. Внутри интерактивной сессии ту же информацию удобно смотреть через /whoami и при необходимости завершать локальный доступ через /logout.
Если нужен headless или автоматизированный сценарий, CLI умеет читать токен через istok-code login --token-stdin или из переменной окружения ISTOK_TOKEN. Это полезнее и безопаснее, чем передавать токен через argv. Передача через обычный --token существует, но для постоянной практики это не лучший путь.
Как выбирать и проверять модель в CLI
Для списка моделей используйте istok-code models или /models. Для выбора модели используйте istok-code models set <id> или соответствующий выбор внутри slash-команды. Для сброса вернитесь на istok-code models clear. Команда /model показывает, какая модель сейчас активна в сессии.
Нужно помнить разницу между локальной командой выбора и реальной доступностью модели. CLI может переключить только ту модель, которую backend реально разрешает для вашего текущего плана. Если модель не видна в списке, сначала проверяйте не интерфейс CLI, а план и набор доступных моделей для аккаунта.
Когда нужны usage, billing и config
Команды usage и billing отвечают за разные вещи. Usage показывает фактическое потребление и квоты. Billing показывает состояние плана и подписки. Эти команды полезно держать рядом, но не путать между собой. В интерактивной сессии доступны /usage и /billing, а вне неё есть отдельные top-level команды istok-code usage и istok-code billing.
Команды config нужны для локального поведения CLI, а не для изменения серверной подписки. Через istok-code config можно читать файл конфигурации, смотреть путь к нему, сбрасывать настройки и менять локальные параметры вроде auto_verify_after_edits. Это важно, чтобы не ожидать, что config внезапно поменяет ваш план или квоту на сервере.
- Usage отвечает на вопрос "что уже потрачено".
- Billing отвечает на вопрос "какой план и что с ним происходит".
- Config отвечает на вопрос "как ведёт себя именно этот локальный CLI".
История локальных сессий и продолжение работы
Для списка последних локальных сессий есть два пути. Вне интерактивного режима используйте флаг --sessions. Внутри интерактивной сессии используйте /sessions [limit]. Для продолжения работы запустите istok-code --resume <id|latest>. Это удобный рабочий маршрут, когда задача была длинной и её нужно поднять именно в том локальном виде, в котором она завершилась.
Не стоит путать локальную историю с серверным usage. Usage показывает потребление и сессии как продуктовые сущности. Флаг --sessions и команда /sessions работают с локальными записями CLI на вашей машине. Поэтому список resumed-сессий на ноутбуке и на сервере может отличаться. CLI автоматически очищает самые старые локальные записи, когда их становится больше 100, — вручную чистить не нужно.
Slash-команды внутри интерактивной сессии
Большинство повседневных действий доступны прямо внутри сессии через slash-команды. Это быстрее, чем выходить и запускать CLI снова. Ниже основные команды и их назначение.
- /help — список доступных slash-команд.
- /plan — переключить режим планирования (агент только планирует, не выполняет).
- /retry — повторить последний ход, завершившийся сетевой или серверной ошибкой. Не требует заново набирать запрос.
- /sessions [limit] — показать список последних локальных сессий.
- /resume <id|latest> — продолжить прошлую локальную сессию.
- /verify — запустить проверки проекта прямо из сессии.
- /fix — передать агенту контекст последнего упавшего verify и запустить исправление.
- /symbols <name> — найти определение символа.
- /project — показать, как CLI видит текущий проект.
- /usage — текущее потребление и остаток квоты.
- /models — список доступных моделей.
- /export — экспортировать транскрипт сессии в Markdown.
- /export json — экспортировать в JSON.
- /quit — завершить сессию.
Неинтерактивный режим: istok-code run
Подкоманда run запускает агента без интерактивной сессии: один запрос, ответ, выход. Это удобно для скриптов, CI и одноразовых задач, когда не нужен диалог. Базовый вариант: istok-code run "найди все TODO в проекте". Флаг --file добавляет файл в контекст, --output-format json переключает вывод в stream-json для машинной обработки.
- istok-code run "запрос" — одноразовый запуск.
- istok-code run --file ./src/db.ts "найди N+1 запросы" — с файлом в контексте.
- istok-code run --output-format json "запрос" — JSON-вывод для CI.
MCP-серверы: что это и для кого
Model Context Protocol (MCP) — стандартный протокол подключения внешних инструментов к агенту. Istok Code поддерживает подключение MCP-серверов через конфигурацию. Это позволяет добавить нестандартные инструменты: доступ к базам данных, внутренние API, специализированный анализ кода.
Это возможность для опытных пользователей. Из коробки готовых MCP-серверов в продукте нет — нужно самостоятельно настраивать сервер и прописывать его в конфигурации. Если вы только начинаете работать с CLI, MCP не нужен для стандартного рабочего маршрута.