Lua Assistant CLI

Терминальный интерфейс для локального Lua Assistant с отдельной историей диалогов и preflight-проверкой окружения.

Что делает CLI

• запускается командой luax
• хранит конфиг в ~/.config/lua-assistant-cli
• хранит историю и UI-state в ~/.local/share/lua-assistant-cli
• при старте проверяет:
  • backend Swagger/OpenAPI на http://127.0.0.1:8000 с автоматическим fallback на http://127.0.0.1:8080
  • наличие в backend contract endpoints /connect, /generate, /stop/{session_id}
  • Ollama на http://127.0.0.1:11434
  • наличие qwen2.5-coder:7b или fallback qwen2.5-coder:latest

Если окружение не готово, CLI не падает со stack trace, а показывает, что именно нужно поднять.

Команды

• luax — открыть полноэкранный TUI
• luax --preflight — только прогнать проверки окружения
• luax --print-config-dir — вывести путь к XDG config dir
• luax --print-data-dir — вывести путь к XDG data dir
• luax --version — версия CLI

TUI

• Tab — переключение фокуса между списком диалогов и композером
• Up/Down — навигация по диалогам
• Enter — выбрать диалог или отправить сообщение
• 1-9 — быстрый выбор видимого диалога в списке
• Esc — вернуть фокус в композер и скрыть help
• Ctrl+C — выход

Команды внутри композера:

• :new
• :conv
• :switch <n>
• :delete <n>
• :stop
• :retry
• :preflight
• :help
• :quit

Разработка

Из каталога client/:

corepack pnpm install
corepack pnpm --filter lua-assistant-cli test
corepack pnpm --filter lua-assistant-cli build
corepack pnpm --filter lua-assistant-cli dev

Обновление CLI

Из каталога client/:

# обновить глобально CLI из текущего локального репо
corepack pnpm run update:cli:local

# обновить глобально CLI из npm registry
corepack pnpm run update:cli:registry

Публикация

Пакет публикуется как npm CLI с bin luax.

Если нужен локальный alias:

alias lua='luax'