CLI
TUI, неинтерактивный режим -p, SPIRIT_API_KEY / SPIRIT_API_BASE и общий демон.
CLI — это терминальный хост. Установите его с помощью скрипта установки. Он общается с тем же демоном, что и Desktop.
TUI
cd /path/to/your/project
spiritМакет может быть inline или fullscreen (-t / --tui, или /tui). Режимы, подтверждения и Loop соответствуют Desktop.
Полезные слеш-команды: /help, /quit, /new, /continue, /loop, /model, /sessions, /rewind, /fork, /subagents, /approval, /mcp, /hooks, /rules, /skills, /extensions.
Неинтерактивный режим
spirit -p "your prompt here"Только окончательный текст ассистента выводится в stdout. Поместите -m, -a и -l перед -p. Процесс завершается с ошибкой, если вызов требует подтверждения или ask_questions. В автономном режиме происходит тайм-аут через 30 минут.
Переменные окружения
| Переменная | Роль |
|---|---|
SPIRIT_API_KEY | API-ключ для этого процесса. Порядок: env → keyring модели → глобальный keyring |
SPIRIT_API_BASE | Переопределение базового URL API |
SPIRIT_AGENT_DATA_DIR | Каталог данных (то же хранилище, что и у Desktop) |
SPIRIT_HOME | Корень установки бинарного файла CLI — не каталог данных |
Общий демон
spirit подключается через WebSocket к демону Spirit Server. Сессии, потоковая передача, инструменты и очередь подтверждений находятся там. Bearer-токен — {spiritDataDir}/server.token (режим 0600). По умолчанию демон привязывается к 127.0.0.1 на случайном порту.
spirit serve запускает демон в фоновом режиме. Удаленный 0.0.0.0 не является открытым продуктовым путем. См. Безопасность.
Команды
spirit [-v] [-m model] [-a approval] [-l language] [-t inline|fullscreen] [-p prompt]
spirit interactive
spirit serve
spirit model list|add|remove|use|current
spirit config show|set-base|set-image-model|clear-image-model|set-video-model|clear-video-model|key set|remove|status
spirit mcp …
spirit hooks list|validate
spirit extension list|import|remove|marketplace …