istok-code-cli

Istok Code — AI-ассистент для работы с кодом в терминале.

Установка

npm install -g istok-code-cli

Проверить установку:

istok-code --help
istok-code --check

Быстрый старт

Интерактивный режим:

istok-code

Одноразовый запуск с prompt:

istok-code "почини failing test и объясни причину"

Обновление

Проверить текущую версию и наличие обновления:

istok-code --version
istok-code info

Обновить до последней версии одной командой:

istok-code update

Или вручную через npm:

npm install -g istok-code-cli@latest

При каждом запуске CLI автоматически проверяет совместимость с сервером. Если доступна новая версия — вы увидите уведомление в терминале. Чтобы применить обновление, выполните istok-code update.

Если обновление требует прав администратора (Linux/macOS), добавьте sudo:

sudo npm install -g istok-code-cli@latest

Вход

Вход через браузер:

istok-code login

Headless-вход по коду устройства для SSH, серверов и CI runner с браузером на другом устройстве:

istok-code login --device

Ручной вход по токену:

echo "$ISTOK_TOKEN" | istok-code login --token-stdin
ISTOK_TOKEN="$ISTOK_TOKEN" istok-code login
istok-code login --token <token>

CI

GitHub Actions:

echo "${{ secrets.ISTOK_TOKEN }}" | istok-code login --token-stdin

GitLab CI:

ISTOK_TOKEN="$ISTOK_TOKEN" istok-code login

Конфигурация

По умолчанию CLI работает с:

https://lk.istok.ai

Переопределить API можно флагом:

istok-code --api-url https://lk.istok.ai

Или через переменную окружения:

ISTOK_API_URL=https://lk.istok.ai istok-code --check

Полезные команды

istok-code status
istok-code update
istok-code info
istok-code models
istok-code models set <model-id>
istok-code usage
istok-code billing
istok-code config list

Security notes

• На macOS токены сохраняются в Keychain.
• На Linux CLI использует Secret Service через secret-tool, если он доступен.
• На Windows CLI использует DPAPI для локального защищённого хранения.
• Если защищённое хранилище ОС недоступно, CLI предупреждает и временно использует ~/.istok/config.json.

Plain mode

Для пайпов и скриптов:

echo "объясни код" | istok-code --pipe

Troubleshooting

Проверка статуса клиента:

istok-code --check

Проверка авторизации:

istok-code status

Повторный вход:

istok-code logout
istok-code login