@iola_adm/iola-cli 0.1.15 → 0.1.19

package/wiki/AI-/320/277/321/200/320/276/321/204/320/270/320/273/320/270.md

@@ -0,0 +1,44 @@
+# AI profiles
+
+CLI поддерживает несколько AI-профилей одновременно.
+
+## Локальная модель
+
+```bash
+iola ai setup ollama
+iola ai profile use local
+iola ask "найди школы на Петрова"
+```
+
+## OpenAI
+
+```bash
+iola ai key set openai
+iola ai setup openai --model gpt-4.1-mini
+iola ask "найди школу 29" --profile openai
+```
+
+## OpenRouter
+
+```bash
+iola ai key set openrouter
+iola ai setup openrouter --model openai/gpt-4.1-mini
+iola ai models openrouter --search qwen
+```
+
+## Codex CLI
+
+```bash
+codex login
+iola ai setup codex --model gpt-5.5
+iola setup codex
+iola ask "проверь данные школы 29" --profile codex
+```
+
+## Переключение
+
+```bash
+iola ai profiles
+iola ai profile use local
+iola ai profile use openrouter
+```

package/wiki/Home.md

@@ -0,0 +1,32 @@
+# iola-cli
+
+`iola-cli` - терминальный инструмент и AI-агент для работы с открытыми данными городского округа "Город Йошкар-Ола".
+
+Основные сценарии:
+
+- поиск школ и детских садов;
+- просмотр карточек организаций;
+- локальная синхронизация данных в SQLite;
+- проверка качества данных;
+- выгрузка CSV/JSON;
+- работа с локальной моделью Ollama;
+- работа с OpenAI, OpenRouter и Codex CLI;
+- подключение публичного MCP-сервера.
+
+Быстрый старт:
+
+```bash
+npm install -g @iola_adm/iola-cli
+iola init
+iola search "Петрова"
+iola ask "найди школу 29"
+```
+
+Подробные страницы:
+
+- [Установка](Установка)
+- [Первый запуск](Первый-запуск)
+- [AI-профили](AI-профили)
+- [Локальный инструментальный агент](Локальный-инструментальный-агент)
+- [Команды](Команды)
+- [Решение проблем](Решение-проблем)

package/wiki//320/232/320/276/320/274/320/260/320/275/320/264/321/213.md

@@ -0,0 +1,60 @@
+# Commands
+
+Основные команды:
+
+```bash
+iola --help
+iola init
+iola doctor
+iola update
+iola version --check
+```
+
+Данные:
+
+```bash
+iola search "Петрова"
+iola search "Петрова" --local --fts
+iola schools --limit 10
+iola kindergartens --search "29"
+iola card "школа 29"
+iola data schools --format csv --output schools.csv
+```
+
+Локальная БД:
+
+```bash
+iola db status
+iola sync
+iola sync status
+iola diff
+iola quality
+```
+
+AI:
+
+```bash
+iola ask "найди школу 29"
+iola ask "найди школу 29" --schema json
+iola ask "найди школу 29" --bare --quiet
+iola agents list
+iola agents run quality-checker "проверь школы"
+```
+
+Интерактивный режим:
+
+```bash
+iola agent
+```
+
+Внутри agent:
+
+```text
+/help
+/tools
+/memory show
+/permissions
+/quality
+/sync
+/exit
+```

package/wiki//320/233/320/276/320/272/320/260/320/273/321/214/320/275/321/213/320/271-/320/270/320/275/321/201/321/202/321/200/321/203/320/274/320/265/320/275/321/202/320/260/320/273/321/214/320/275/321/213/320/271-/320/260/320/263/320/265/320/275/321/202.md

@@ -0,0 +1,36 @@
+# Local tool-agent
+
+Режим `--tools` предназначен для локальных моделей Ollama. Маленькая модель не выполняет действия напрямую, а предлагает JSON-план. CLI проверяет план и выполняет только разрешенные встроенные tools.
+
+Пример:
+
+```bash
+iola ask "выгрузи школы на Петрова в csv" --profile local --tools
+iola ask "найди детсады без телефона" --profile local --tools --reasoning verify
+```
+
+Доступные tools:
+
+- `search_local`
+- `get_card`
+- `export_data`
+- `run_report`
+- `save_view`
+
+Управление разрешениями:
+
+```bash
+iola permissions list
+iola permissions deny export_data
+iola permissions allow export_data
+```
+
+Режимы планирования:
+
+```bash
+--reasoning fast
+--reasoning verify
+--reasoning vote
+```
+
+Если Ollama недоступна или модель вернула некорректный JSON, CLI использует fallback-планировщик для типовых запросов.

package/wiki//320/237/320/265/321/200/320/262/321/213/320/271-/320/267/320/260/320/277/321/203/321/201/320/272.md

@@ -0,0 +1,38 @@
+# First run
+
+Первый запуск:
+
+```bash
+iola init
+```
+
+Команда проверит:
+
+- Node.js и npm;
+- локальную SQLite-БД;
+- доступность публичного API/MCP;
+- Ollama и подходящую локальную модель;
+- обновления npm-пакета.
+
+Диагностика:
+
+```bash
+iola doctor
+iola doctor --summary
+iola ai doctor
+iola db status
+```
+
+Синхронизация локальной базы:
+
+```bash
+iola sync
+iola sync status
+```
+
+Проверка данных:
+
+```bash
+iola quality
+iola diff
+```

package/wiki//320/240/320/265/321/210/320/265/320/275/320/270/320/265-/320/277/321/200/320/276/320/261/320/273/320/265/320/274.md

@@ -0,0 +1,47 @@
+# Troubleshooting
+
+## Команда iola не найдена
+
+Проверьте глобальную установку:
+
+```bash
+npm install -g @iola_adm/iola-cli
+npm bin -g
+```
+
+## Нужна новая версия Node.js
+
+```bash
+node --version
+iola init --upgrade-node
+```
+
+## Ollama недоступна
+
+```bash
+ollama --version
+ollama serve
+iola ai doctor
+```
+
+## OpenAI/OpenRouter key не найден
+
+```bash
+iola ai key status
+iola ai key set openai
+iola ai key set openrouter
+```
+
+## Нет локальных данных
+
+```bash
+iola sync
+iola sync status
+iola search "школа" --local
+```
+
+## Нужен подробный лог
+
+```bash
+iola --debug --debug-file iola-debug.log doctor
+```

package/wiki//320/243/321/201/321/202/320/260/320/275/320/276/320/262/320/272/320/260.md

@@ -0,0 +1,58 @@
+# Installation
+
+## Требования
+
+Нужен Node.js `22.5.0` или новее:
+
+```bash
+node --version
+npm --version
+```
+
+Установка Node.js:
+
+```bash
+# Windows
+winget install OpenJS.NodeJS.LTS
+
+# macOS
+brew install node
+
+# Linux
+curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
+sudo apt-get install -y nodejs
+```
+
+## Установка CLI
+
+```bash
+npm install -g @iola_adm/iola-cli
+iola --help
+```
+
+Без глобальной установки:
+
+```bash
+npx -y @iola_adm/iola-cli init
+```
+
+## Ollama для локальной модели
+
+```bash
+# Windows
+winget install Ollama.Ollama
+
+# macOS
+brew install --cask ollama
+
+# Linux
+curl -fsSL https://ollama.com/install.sh | sh
+```
+
+Проверка:
+
+```bash
+ollama --version
+iola ai doctor
+iola ai setup ollama
+```