CLI reference

Эта страница перечисляет CLI-поверхность SOBA Agent v0.6.x, которая доступна из консоли.

1. Режимы запуска

2. Top-level флаги

Session и режимы

Provider и модель

Model ID без квалификатора остаётся на настроенном default provider. Значение openrouter/deepseek/deepseek-v4-flash явно выбирает openrouter и передаёт ему model ID deepseek/deepseek-v4-flash.

Лимиты

Интерфейс и поведение

Sound

Информация

3. Proof-команды

Proof bundles сохраняются в .soba/evidence/*.soba-proof.json после accepted finish агента. Текущие proof bundles включают компактный evidence index, finish claims, измененные файлы, checks, commands, permission receipts, risks и review actions. Permission receipts записывают trust level, approval kind, approval value, decision, reason и более безопасные альтернативы, когда SOBA может предложить least-privilege rewrite; auto означает, что trust policy SOBA разрешила вызов без запроса подтверждения. Новые receipts также содержат proofId, runId и SHA-256 integrity.digest. soba verify проверяет schema и content integrity, ссылки supported claims, outcomes команд, порядок mutations, полноту diff, permissions и redaction секретов.

soba prove, soba verify и soba explain-claim не запускают agent runtime и не требуют credentials провайдера.

У soba verify стабильные policy exits: 0 verified, 1 invalid, 2 partially verified, 3 unverified и 4 blocked. JSON содержит accepted, outcome, reason и exitCode. Legacy receipts без integrity metadata остаются читаемыми, но понижаются до partially_verified с reason legacy_unsealed_proof и exit code 2.

4. Project Memory команды

Project Memory хранится в .soba/memory/. soba memory doctor проверяет persisted knowledge files и memory capsules без запуска agent runtime. Команда показывает количество knowledge files, оценку token usage, provenance источников capsules, stale capsules, отсутствующие источники, ссылки за пределы проекта и битые capsule files.

Exit code равен 0 только для состояния healthy. Stale или broken memory возвращает 1 и пишет отчёт в stderr. Для soba memory stale exit code равен 0 только если нет stale или broken capsules и нет memory doctor issues. Для soba memory verify exit code равен 0 только если verification report содержит verified: true. Для soba memory explain exit code равен 0 только если найдена хотя бы одна capsule, которую безопасно использовать; stale, broken или отсутствующие matches возвращают 1.

soba memory doctor, soba memory stale, soba memory verify и soba memory explain не запускают agent runtime и не требуют credentials провайдера.

5. Provider subcommands

Provider registry управляется через sub-route soba provider.

soba provider add

Поддержанные флаги:

Формат --model:

id=name,contextWindow,maxOutput[,supportsStreaming[,supportsThinking]]

Пример keyless local provider:

soba provider add ollama \
  --base-url http://localhost:11434/v1 \
  --model llama3.1="Llama 3.1",8192,2048 \
  --set-active

8192,2048 — бережные стартовые значения для локальной модели: сначала контекстное окно, затем максимум выходных токенов. Большие значения вроде 128000,8192 могут резко нагрузить память и сильно замедлить ноутбук.

5. Практические команды проверки

soba --version
soba --help
soba prove --last
soba verify --last
soba explain-claim claim_1 --last
soba provider list
soba --no-session --max-agent-iterations 1 "Ответь одним словом: ok"

Для разработки в репозитории:

soba -i --lang ru --theme graphite

6. Direct shell в TUI

В интерактивном режиме shell-команды можно запускать напрямую:

!git status --short
!bun test
!!bun run build

! выполняет команду сразу, !! выполняет команду без вывода в transcript. Если нужно, чтобы агент увидел и проанализировал output, попросите его выполнить команду через обычный prompt — тогда будет использован bash tool.

Что дальше

• Провайдеры и модели
• Интерфейс и команды
• Конфигурация