npm - @freeclaude/cli - Versions diffs - 3.0.4 → 3.0.5 - Mend

@freeclaude/cli 3.0.4 → 3.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/README.md CHANGED Viewed

@@ -1,17 +1,16 @@
 <div align="center">
-# 🆓 FreeClaude v3.0.0
+# 🆓 FreeClaude v3
-**Бесплатный AI-ассистент для разработки — Fallback Chain, Semantic Memory, Voice, MCP, PM Tools**
+**The Best Free AI Coding Agent — Fallback Chain, Semantic Memory, Voice, MCP, PM Tools**
-Форк Claude Code без привязки к OAuth. Работает с любым OpenAI-совместимым провайдером.
+Fork of Claude Code without OAuth lock-in. Works with any OpenAI-compatible provider.
 [![v3.0.0](https://img.shields.io/badge/version-3.0.0-brightgreen)](https://github.com/alexgrebeshok-coder/freeclaude/releases)
 [![Phase 0-4 Done](https://img.shields.io/badge/Phase-0..4%20Done%20%7C%20Launch%20Ready-brightgreen)](https://github.com/alexgrebeshok-coder/freeclaude)
-[![Tests](https://img.shields.io/badge/tests-57%2F57%20pass-brightgreen)](https://github.com/alexgrebeshok-coder/freeclaude)
-[![Rust](https://img.shields.io/badge/Tauri-Desktop%20App-orange)](https://github.com/alexgrebeshok-coder/freeclaude/tree/main/desktop)
+[![Tests](https://img.shields.io/badge/tests-70%2F70%20pass-brightgreen)](https://github.com/alexgrebeshok-coder/freeclaude)
+[![Rust](https://img.shields.io/badge/Rust-Tauri%20Desktop-orange)](https://github.com/alexgrebeshok-coder/freeclaude/tree/main/desktop)
 [![VS Code](https://img.shields.io/badge/VS%20Code-Extension-blue)](https://github.com/alexgrebeshok-coder/freeclaude/tree/main/extension)
-[![MCP](https://img.shields.io/badge/MCP-Servers%20Included-purple)](https://github.com/alexgrebeshok-coder/freeclaude/tree/main/mcp-servers)
 [![License](https://img.shields.io/badge/License-MIT-blue)](LICENSE)
 [English](#english) · [Русский](#русский)
@@ -22,500 +21,173 @@
 ## 🇷🇺 Русский
-### Зачем FreeClaude
+### Что нового в v3
-Claude Code — мощный инструмент, но он привязан к подписке Anthropic ($20/мес) и требует OAuth-авторизацию. FreeClaude снимает эти ограничения: вы используете любые модели от бесплатных (ZAI, Ollama, Gemini) до платных (OpenAI, DeepSeek) с автоматическим переключением при сбоях.
+| Фаза | Фичи | Статус |
+|------|-------|--------|
+| **Phase 0** | 🔧 Quality foundation, branding, CI/CD | ✅ |
+| **Phase 1** | 🗂️ `/undo`, `/repo-map`, Voice, Fallback, Memory, Cost tracking | ✅ |
+| **Phase 2** | 🪝 Hooks (26 types), Plugins (20K+ lines), Desktop App (Tauri) | ✅ |
+| **Phase 3** | 💻 VS Code Extension, MCP servers, Background Agents | ✅ |
+| **Phase 4** | 🚀 Launch: npm, Homebrew, Docker | ✅ |
-**Что вы получаете бесплатно, что у конкурентов платно или отсутствует:**
+### Уникальные фичи (нет у конкурентов)
-- 🔄 Автоматическое переключение между провайдерами (Fallback Chain)
-- 🧠 Семантическая память между сессиями (GBrain)
-- 🎙️ Голосовой режим (STT + TTS, бесплатно)
-- 🏗️ Управление проектами через MCP (EVM, CPI, SPI)
-- 🏢 Доступ к данным 1С:Предприятие через OData
-- 🖥 Нативное десктоп-приложение (Tauri)
-- 💻 Расширение для VS Code
-- 🪝 Система хуков (26 типов событий)
-- 🇷🇺 Полная поддержка русского языка
+- 🏗️ **CEOClaw PM MCP** — управление проектами прямо в coding agent (EVM, CPI, SPI)
+- 🏢 **1С OData MCP** — доступ к данным 1С:Предприятие (Альфа-Авто, БАЗИС)
+- 🔄 **Multi-Provider Fallback** — автоматическое переключение между ZAI, Ollama, Gemini
+- 🧠 **GBrain Semantic Memory** — семантическая память через локальные embeddings
+- 🎙️ **Voice Mode** — Whisper STT + Edge TTS (бесплатно, локально)
+- 🇷🇺 **Russian Locale** — полная поддержка русского языка
----
-### Установка
-**Способ 1 — npm (рекомендуется):**
-```bash
-npm install -g @freeclaude/cli
-freeclaude
-```
+### Быстрый старт
-**Способ 2 — из исходников:**
 ```bash
+# 1. Clone & build
 git clone https://github.com/alexgrebeshok-coder/freeclaude.git
 cd freeclaude
 bun install && bun run build
-node dist/cli.mjs
-```
-**Десктоп-приложение (Tauri):**
-```bash
-git clone https://github.com/alexgrebeshok-coder/freeclaude.git
-cd freeclaude/desktop
-npm install && npm run tauri dev
-```
-**Расширение VS Code:**
-```bash
-git clone https://github.com/alexgrebeshok-coder/freeclaude.git
-cd freeclaude/extension
-npm install && npm run compile
-# Затем загрузите папку extension/ в VS Code: Extensions → ... → Load from Directory
-```
----
-### Быстрый старт (3 шага)
-```bash
-# 1. Установите
-npm install -g @freeclaude/cli
+# 2. Configure providers
+cp .freeclaude.example.json ~/.freeclaude.json
+# Edit ~/.freeclaude.json with your API keys
-# 2. Настройте провайдера (минимум один)
-freeclaude
-> /setup free          # покажет бесплатные варианты
-> /setup zai           # добавит ZAI (ключ берёт из ZAI_API_KEY)
-# 3. Пишите код!
-> Напиши REST API для блога на FastAPI
+# 3. Start coding!
+node dist/cli.mjs
 ```
----
+### Поддерживаемые провайдеры
-### Конфигурация
-Файл `~/.freeclaude.json` — главный конфиг. Поддерживает синтаксис `env:KEY_NAME` для ключей из переменных окружения:
-```json
-{
-  "providers": [
-    {
-      "name": "zai",
-      "baseUrl": "https://api.z.ai/api/coding/paas/v4",
-      "apiKey": "env:ZAI_API_KEY",
-      "model": "glm-4.7-flash",
-      "priority": 1,
-      "timeout": 30000
-    },
-    {
-      "name": "ollama",
-      "baseUrl": "http://localhost:11434/v1",
-      "apiKey": "ollama",
-      "model": "qwen2.5:7b",
-      "priority": 2,
-      "timeout": 60000
-    }
-  ]
-}
-```
----
+| Провайдер | Цена | Модель | Статус |
+|-----------|------|--------|--------|
+| 🇷🇺 **ZAI (GLM)** | Бесплатно | glm-4.7-flash, glm-5-turbo, **glm-5.1** | ✅ |
+| 🏠 **Ollama** | Бесплатно | qwen2.5:3b, llama3, any local | ✅ |
+| 🌐 **Google Gemini** | Free tier | gemini-2.5-flash-lite | ✅ |
+| 💰 **OpenAI** | Paid | gpt-4o, gpt-4o-mini | ✅ |
+| 💰 **DeepSeek** | Cheap | deepseek-chat, deepseek-r1 | ✅ |
+| 🔧 **Any OpenAI-compatible** | — | any model | ✅ |
 ### Управление провайдерами и моделями
-FreeClaude поддерживает **19+ провайдеров** с единым интерфейсом. Вы можете использовать одновременно несколько бесплатных и платных провайдеров — система автоматически переключится при сбое текущего.
-#### Просмотр и переключение моделей
+**Просмотр и переключение:**
 ```
-/model                          — список всех провайдеров и моделей
-/model 1                        — переключиться на провайдера #1
-/model openrouter               — переключиться по имени провайдера
+/model                      — список всех провайдеров
+/model 1                    — переключиться на провайдера #1
+/model openrouter           — переключиться по имени
 /model openrouter anthropic/claude-sonnet-4   — сменить модель внутри провайдера
 ```
-**Зачем:** Один проект — разные задачи. Быстрые модели для рефакторинга, мощные — для архитектуры. Переключайтесь одной командой.
-#### Добавление провайдеров
+**Добавление провайдеров:**
 ```
-/setup                          — главное меню (все категории)
-/setup free                     — только бесплатные провайдеры
-/setup local                    — локальные (Ollama, LM Studio)
-/setup paid                     — платные (OpenAI, DeepSeek, Anthropic)
-/setup router                   — роутеры (OpenRouter — 200+ моделей)
-/setup ollama                   — быстрое добавление Ollama (без ключа)
-/setup openrouter               — быстрое добавление OpenRouter
-/setup zai                      — быстрое добавление ZAI
-/setup add 2 API_KEY            — добавить провайдера #2 с ключом
-/setup remove 2                 — удалить провайдера #2
+/setup                      — главное меню (категории и список)
+/setup free                 — показать бесплатные провайдеры
+/setup local                — локальные (Ollama, LM Studio)
+/setup paid                 — платные (OpenAI, DeepSeek)
+/setup router               — роутеры (OpenRouter — 200+ моделей)
+/setup ollama               — быстрое добавление Ollama
+/setup openrouter           — быстрое добавление OpenRouter (ключ из env)
+/setup zai                  — быстрое добавление ZAI (ключ из env)
+/setup add 2 API_KEY        — добавить провайдера #2 с ключом
+/setup remove 2             — удалить провайдера #2
 ```
-**Зачем:** Не нужно помнить URL и формат конфига — `/setup` всё сделает сам.
-#### Тестирование подключения
+**Тест подключения:**
 ```
-/providers test                 — пинг всех провайдеров с отображением latency
+/providers test             — пинг всех провайдеров (latency)
 ```
-**Зачем:** Проверьте, что ключи работают и серверы доступны, прежде чем начать работу.
----
 ### Бесплатные провайдеры
-| Провайдер | Модели | Ключ | Регистрация | Скорость |
-|-----------|--------|------|-------------|----------|
-| 🇷🇺 **ZAI (GLM)** | glm-4.7-flash, glm-5-turbo, **glm-5.1** | `ZAI_API_KEY` | [open.bigmodel.cn](https://open.bigmodel.cn/) | ~15с (reasoning) |
-| 🏠 **Ollama** | qwen2.5:7b, llama3, any local | Не нужен | `ollama pull qwen2.5:7b` | ~1-2с |
-| 🌐 **Google Gemini** | gemini-2.5-flash-lite | `GEMINI_API_KEY` | [aistudio.google.com](https://aistudio.google.com/apikey) | ~3с |
-| ⚡ **Groq** | llama-3.3-70b, mixtral | `GROQ_API_KEY` | [console.groq.com](https://console.groq.com/keys) | ~1с |
-| 🚀 **Cerebras** | llama-3.3-70b | `CEREBRAS_API_KEY` | [cloud.cerebras.ai](https://cloud.cerebras.ai) | ~0.5с |
-| 🇨🇳 **Qwen/DashScope** | qwen-plus, qwen-max | `DASHSCOPE_API_KEY` | [dashscope.console.aliyun.com](https://dashscope.console.aliyun.com/) | ~3с |
-**Пример — подключение ZAI за 1 минуту:**
-```bash
-# 1. Получите ключ на open.bigmodel.cn (бесплатная регистрация)
-# 2. Добавьте в ~/.zshrc
-echo 'export ZAI_API_KEY=ваш-ключ' >> ~/.zshrc && source ~/.zshrc
-# 3. В FreeClaude:
-freeclaude
-> /setup zai
-> /model zai
-```
-**Пример — локальная модель через Ollama:**
-```bash
-# 1. Установите Ollama: curl -fsSL https://ollama.ai/install.sh | sh
-# 2. Скачайте модель: ollama pull qwen2.5:7b
+| Провайдер | Ключ | Регистрация | Скорость |
+|-----------|------|-------------|----------|
+| 🇷🇺 ZAI (GLM-5) | `ZAI_API_KEY` | [open.bigmodel.cn](https://open.bigmodel.cn/) | ~15с (reasoning) |
+| 🇺🇸 Google Gemini | `GEMINI_API_KEY` | [aistudio.google.com](https://aistudio.google.com/apikey) | ~3с |
+| ⚡ Groq | `GROQ_API_KEY` | [console.groq.com](https://console.groq.com/keys) | ~1с |
+| 🚀 Cerebras | `CEREBRAS_API_KEY` | [cloud.cerebras.ai](https://cloud.cerebras.ai) | ~0.5с |
+| 🇨🇳 Qwen/DashScope | `DASHSCOPE_API_KEY` | [dashscope.console.aliyun.com](https://dashscope.console.aliyun.com/) | ~3с |
+| 🏠 Ollama (local) | Не нужен | `ollama pull qwen2.5:7b` | ~1-2с |
+| 🔀 OpenRouter | `OPENROUTER_API_KEY` | [openrouter.ai](https://openrouter.ai/keys) | зависит от модели |
+**Как подключить (пример OpenRouter):**
+```bash
+# 1. Получить ключ на openrouter.ai/keys
+# 2. Добавить в ~/.zshrc
+echo 'export OPENROUTER_API_KEY=sk-or-твой-ключ' >> ~/.zshrc
+source ~/.zshrc
 # 3. В FreeClaude:
-freeclaude
-> /setup ollama
-> /model ollama
-```
----
-### Multi-Provider Fallback Chain
-**Что это:** Если текущий провайдер не отвечает, таймаутит или возвращает ошибку — FreeClaude автоматически переключается на следующий по приоритету. Приоритет задаётся полем `priority` в конфиге (1 = высший).
-**Зачем:** Вы не теряете рабочий контекст из-за сбоя одного провайдера. Система переключается незаметно и продолжает работу.
-**Как настроить:**
-```json
-{
-  "providers": [
-    { "name": "zai", "priority": 1 },
-    { "name": "ollama", "priority": 2 },
-    { "name": "gemini", "priority": 3 }
-  ]
-}
-```
-Если ZAI упадёт — переключится на Ollama, затем на Gemini. Все три бесплатные.
----
-### Slash Commands (все команды)
-| Команда | Описание | Пример |
-|---------|----------|--------|
-| `/model` | Список / переключение провайдера и модели | `/model openrouter` |
-| `/setup` | Добавление, удаление, настройка провайдеров | `/setup free` |
-| `/commit` | AI-коммит с анализом diff | `/commit` |
-| `/diff` | Просмотр незакоммиченных изменений | `/diff` |
-| `/undo [N]` | Откат последних N коммитов (soft reset) | `/undo 3` |
-| `/repo-map` | Обзор структуры репозитория | `/repo-map` |
-| `/providers test` | Пинг всех провайдеров с latency | `/providers test` |
-| `/cost` | Статистика стоимости (сегодня / неделя / месяц) | `/cost` |
-| `/remember <key> <value>` | Сохранить факт в память | `/remember db postgres` |
-| `/recall <key>` | Поиск в памяти по ключу или смыслу | `/recall database` |
-| `/forget <key>` | Удалить факт из памяти | `/forget db` |
-| `/memories` | Список всех сохранённых фактов | `/memories` |
-| `/run <task>` | Запустить фоновую AI-задачу | `/run напиши тесты для auth.ts` |
-| `/jobs` | Список фоновых задач со статусами | `/jobs` |
-| `/job <id>` | Результат конкретной фоновой задачи | `/job 3` |
-| `/hooks` | Управление хуками | `/hooks` |
-| `/memory` | Редактировать CLAUDE.md файлы проекта | `/memory` |
-| `/status` | Текущая сессия, провайдер, модель | `/status` |
-| `/daily` | Итоги дня | `/daily` |
----
-### Память (GBrain Semantic Memory)
-**Что это:** Система, которая запоминает факты о вашем проекте между сессиями. Использует локальные эмбеддинги для семантического поиска — вы можете найти информацию даже по описанию, а не только по точному ключу.
-**Зачем:** Не нужно каждый раз объяснять AI, что вы используете PostgreSQL, что API на FastAPI, что проект монорепо и т.д. Память сохраняется локально и работает между сессиями.
-**Как пользоваться:**
-```
-> /remember db postgres          # Запомнить: база данных — PostgreSQL
-> /remember framework fastapi    # Запомнить: фреймворк — FastAPI
-> /remember style black          # Запомнить: стиль кода — Black
-> /recall database               # Найти: "database" или "база данных"
-> /recall фреймворк              # Семантический поиск по смыслу
-> /memories                      # Показать все сохранённые факты
-> /forget db                     # Удалить конкретный факт
-```
----
-### Голосовой режим (Voice Mode)
-**Что это:** Говорите с FreeClaude голосом. Распознавание речи через OpenAI Whisper (STT), озвучка ответов через Microsoft Edge TTS (TTS). Всё работает бесплатно и локально.
-**Зачем:** Не нужно печатать длинные описания задач — просто скажите. Удобно, когда руки заняты или вы обсуждаете архитектуру вслух.
-**Как включить:** Голосовой режим активируется через соответствующие настройки в интерфейсе (поддерживается в CLI и Desktop App).
----
-### Фоновые агенты (Background Agents)
-**Что это:** Запускайте AI-задачи в фоне, пока продолжаете работать в основной сессии. Агент выполнит задачу самостоятельно и сохранит результат.
-**Зачем:** Не ждите, пока AI напишет тесты — отправьте задачу в фон и продолжайте кодить. Проверьте результат позже.
-**Как пользоваться:**
-```
-> /run напиши unit-тесты для src/auth.ts   # Запустить фоновую задачу
-> /jobs                                     # Список задач со статусами
-> /job 3                                    # Показать результат задачи #3
-```
----
-### Хуки (Hook System)
-**Что это:** Система из 26 типов событий, на которые можно реагировать автоматически. FreeClaude включает 5 предустановленных хуков безопасности.
-**Зачем:** Автоматизация рутинных проверок: запрет коммита секретов, автопроверка форматирования, уведомления о долгих задачах.
-**Предустановленные хуки:**
-- 🛡️ **prevent-secret-commit** — предупреждает перед коммитом `.env` и файлов с кредами
-- 🗑️ **prevent-rm-without-trash** — блокирует `rm -rf`, предлагает `trash` вместо этого
-- ✨ **auto-format-check** — предлагает форматирование после редактирования кода
-- 📝 **git-commit-tracker** — отслеживает AI-коммиты для `/undo`
-- ⏰ **long-task-notify** — уведомления о задачах, которые выполняются слишком долго
-**Как управлять:**
-```
-> /hooks    # Показать список хуков и их статусы
-```
----
-### Стоимость (Cost Tracking)
-**Что это:** FreeClaude считает стоимость каждого запроса на основе токенов и цены модели. Данные доступны по команде `/cost`.
-**Зачем:** Контролируйте расходы, особенно при использовании платных моделей. Понимайте, сколько стоит каждая сессия, день, неделя.
-**Как пользоваться:**
-```
-> /cost     # Статистика: сегодня / неделя / месяц / всего
-```
----
-### Команды для работы с Git
-```
-> /commit           # AI анализирует git diff и создаёт осмысленный коммит
-> /diff             # Показать незакоммиченные изменения
-> /undo 3           # Откатить последние 3 коммита (soft reset, без потери кода)
-> /repo-map         # Обзор структуры репозитория (папки, файлы, зависимости)
+/setup openrouter
+/model openrouter anthropic/claude-sonnet-4
 ```
-**Зачем:** Не нужно думать над сообщением коммита — AI сам проанализирует изменения и напишет описательный коммит. `/undo` — страховка от ошибочных коммитов.
----
-### MCP Серверы (Model Context Protocol)
-MCP — протокол для подключения внешних инструментов к AI-ассистенту. FreeClaude включает два готовых MCP-сервера.
-#### CEOClaw PM — Управление проектами
-**Что это:** Инструменты для управления проектами на основе EVM (Earned Value Management) — методологии оценки прогресса через стоимость выполненных работ.
-**Зачем:** Планируйте задачи, отслеживайте бюджет и сроки прямо в чате с AI. Получайте метрики CPI (стоимость) и SPI (расписание) в реальном времени.
-**Инструменты (7):**
-| Инструмент | Описание |
-|-----------|----------|
-| `pm_project_create` | Создать проект (название, бюджет, валюта) |
-| `pm_project_list` | Список проектов с количеством задач |
-| `pm_task_create` | Создать задачу (проект, название, приоритет, часы) |
-| `pm_task_update` | Обновить задачу (статус, затраченные часы, ответственный) |
-| `pm_evm` | Метрики EVM (CPI, SPI, EAC, здоровье проекта) |
-| `pm_evm_record` | Записать данные PV/EV/AC |
-| `pm_status` | Обзорная панель всех проектов |
-**Установка и запуск:**
-```bash
-cd mcp-servers/ceoclaw-pm
-npm install && npm start
-```
-**Данные хранятся локально:**
-- `~/.freeclaude/pm/projects.json` — проекты
-- `~/.freeclaude/pm/tasks.json` — задачи
-- `~/.freeclaude/pm/evm.json` — точки данных EVM
-#### 1С OData — Доступ к данным 1С:Предприятие
-**Что это:** Только чтение данных из 1С через OData-протокол. Работает с любыми конфигурациями, у которых включён OData-сервис.
-**Зачем:** Запрашивайте данные из 1С прямо в чате: остатки на складе, документы, справочники, финансовые отчёты — без выхода из IDE.
-**Совместимые конфигурации:**
-- Альфа-Авто (автодилеры)
-- БАЗИС (строительство)
-- ERP Управление предприятием
-- Бухгалтерия
-- Любая кастомная конфигурация с включённым OData
-**Инструменты (6):**
-| Инструмент | Описание |
-|-----------|----------|
-| `odata_config` | Проверить статус конфигурации |
-| `odata_list_entities` | Список всех OData-сущностей |
-| `odata_metadata` | Типы и свойства сущностей |
-| `odata_query` | Запрос с фильтрами, выборкой полей, пагинацией |
-| `odata_count` | Подсчёт записей с фильтром |
-| `odata_financial_summary` | Автообнаружение финансовых сущностей |
-**Установка и настройка:**
-```bash
-cd mcp-servers/onec-odata
-npm install && npm start
-```
-Конфигурация — файл `~/.freeclaude/onec-config.json`:
-```json
-{
-  "baseUrl": "https://1c.company.ru/your_db/odata/standard.odata",
-  "username": "odata_user",
-  "password": "odata_password"
-}
-```
----
-### Десктоп-приложение (Tauri)
-**Что это:** Нативное приложение для macOS, Windows и Linux, построенное на Tauri (Rust + Web). Включает чат-интерфейс, панель статуса провайдеров и дашборд стоимости.
-**Зачем:** Альтернатива терминалу для тех, кому удобнее оконный интерфейс. Легче Electron, быстрее запускается, меньше потребляет ресурсов.
-**Запуск:**
-```bash
-cd desktop
-npm install && npm run tauri dev
-```
-**Сборка:**
-```bash
-cd desktop
-npm run tauri build
-```
+### Slash Commands
----
+| Команда | Описание |
+|---------|----------|
+| `/model` | Переключить провайдера/модель |
+| `/setup` | Добавить/удалить провайдера |
+| `/commit` | AI-коммит с анализом изменений |
+| `/diff` | Просмотр незакоммиченных изменений |
+| `/undo [N]` | Откат последних N коммитов (soft reset) |
+| `/repo-map` | Обзор структуры репозитория |
+| `/providers test` | Пинг всех провайдеров (latency) |
+| `/cost` | Статистика стоимости (today/week/month) |
+| `/remember <key> <value>` | Сохранить факт в память |
+| `/recall <key>` | Найти в памяти |
+| `/forget <key>` | Удалить из памяти |
+| `/memories` | Список всех сохранённых фактов |
+| `/run <task>` | Запустить фоновую AI-задачу |
+| `/jobs` | Список фоновых задач |
+| `/job <id>` | Результат фоновой задачи |
+| `/hooks` | Управление хуками (26 типов событий) |
+| `/memory` | Редактировать CLAUDE.md файлы |
+| `/status` | Текущая сессия и провайдер |
+### Hook System
+FreeClaude includes 5 pre-configured safety hooks:
+- 🛡️ `prevent-secret-commit` — warns before committing .env/credentials
+- 🗑️ `prevent-rm-without-trash` — blocks `rm -rf`, suggests `trash`
+- ✨ `auto-format-check` — suggests formatting after code edits
+- 📝 `git-commit-tracker` — tracks AI commits for `/undo`
+- ⏰ `long-task-notify` — notifications for slow tasks
-### Расширение VS Code
+### MCP Servers
-**Что это:** Интеграция FreeClaude прямо в VS Code. Чат, объяснение кода и исправление ошибок — без переключения между окнами.
+**CEOClaw PM** (6 tools):
+`pm_project_create`, `pm_project_list`, `pm_task_create`, `pm_task_update`, `pm_evm`, `pm_status`
-**Зачем:** Не нужно открывать отдельный терминал — задавайте вопросы AI прямо в редакторе.
-**Установка:**
-```bash
-cd extension
-npm install && npm run compile
-# VS Code → Extensions → ⋯ → Load from Directory → выбрать папку extension/
-```
----
+**1С OData** (5 tools):
+`odata_list_entities`, `odata_query`, `odata_count`, `odata_metadata`, `odata_financial_summary`
 ### Сравнение с конкурентами
-| Фича | FreeClaude | Claude Code | Cline | Aider |
-|-------|-----------|-------------|-------|-------|
-| **Цена** | 🆓 Бесплатно | $20/мес | Бесплатно | Бесплатно |
-| **Fallback Chain** | ✅ Авто | ❌ | ❌ | ❌ |
-| **Semantic Memory** | ✅ GBrain | ❌ | ❌ | ❌ |
-| **Voice Mode** | ✅ Бесплатно | 🔒 Платно | ❌ | ❌ |
-| **PM Tools (EVM)** | ✅ MCP | ❌ | ❌ | ❌ |
-| **1С Интеграция** | ✅ OData MCP | ❌ | ❌ | ❌ |
-| **Хуки** | ✅ 26 типов | Частично | ❌ | ❌ |
-| **Desktop App** | ✅ Tauri | ❌ | ❌ | ❌ |
-| **VS Code** | ✅ Extension | ✅ | ✅ | ✅ |
-| **Провайдеры** | 19+ | 1 (Anthropic) | 15+ | 10+ |
-| **Русский язык** | ✅ | ❌ | ❌ | ❌ |
-| **Cost Tracking** | ✅ | ❌ | ❌ | ❌ |
+| Фича | FreeClaude | Claude Code | Cline | Aider | OpenWork |
+|-------|-----------|-------------|-------|-------|----------|
+| Цена | 🆓 Free | $20/мес | Free | Free | Free |
+| Fallback Chain | ✅ | ❌ | ❌ | ❌ | ❌ |
+| Semantic Memory | ✅ GBrain | ❌ | ❌ | ❌ | Obsidian |
+| Voice Mode | ✅ | 🔒 Paid | ❌ | ❌ | ✅ |
+| PM Tools | ✅ MCP | ❌ | ❌ | ❌ | ❌ |
+| 1С Integration | ✅ MCP | ❌ | ❌ | ❌ | ❌ |
+| Hooks | ✅ 5 built-in | ✅ | ❌ | ❌ | ❌ |
+| Russian Locale | ✅ | ❌ | ❌ | ❌ | ❌ |
 ---
 ## 🇬🇧 English
-### Why FreeClaude
-Claude Code is powerful, but it's locked behind a $20/month subscription and requires OAuth. FreeClaude removes these constraints: use any model from free providers (ZAI, Ollama, Gemini) to paid ones (OpenAI, DeepSeek) with automatic failover.
+### Quick Start
-### Installation
-**Via npm (recommended):**
-```bash
-npm install -g @freeclaude/cli
-freeclaude
-```
-**From source:**
 ```bash
 git clone https://github.com/alexgrebeshok-coder/freeclaude.git
 cd freeclaude
 bun install && bun run build
+cp .freeclaude.example.json ~/.freeclaude.json
 node dist/cli.mjs
 ```
-**Desktop App (Tauri):**
-```bash
-cd desktop && npm install && npm run tauri dev
-```
-**VS Code Extension:**
-```bash
-cd extension && npm install && npm run compile
-# Then: VS Code → Extensions → ⋯ → Load from Directory → select extension/
-```
----
-### Quick Start (3 steps)
-```bash
-# 1. Install
-npm install -g @freeclaude/cli
-# 2. Configure a provider
-freeclaude
-> /setup free          # show free options
-> /setup zai           # add ZAI (uses ZAI_API_KEY from env)
-# 3. Start coding!
-> Write a REST API for a blog using FastAPI
-```
----
-### Configuration
-File: `~/.freeclaude.json`. Supports `env:KEY_NAME` syntax for environment variables:
+### Config (`~/.freeclaude.json`)
 ```json
 {
@@ -523,158 +195,26 @@ File: `~/.freeclaude.json`. Supports `env:KEY_NAME` syntax for environment varia
     {
       "name": "zai",
       "baseUrl": "https://api.z.ai/api/coding/paas/v4",
-      "apiKey": "env:ZAI_API_KEY",
+      "apiKey": "your-key",
       "model": "glm-4.7-flash",
       "priority": 1,
       "timeout": 30000
-    },
-    {
-      "name": "ollama",
-      "baseUrl": "http://localhost:11434/v1",
-      "apiKey": "ollama",
-      "model": "qwen2.5:7b",
-      "priority": 2,
-      "timeout": 60000
     }
   ]
 }
 ```
----
-### Provider Management
-FreeClaude supports **19+ providers** with a unified interface. Use multiple free and paid providers simultaneously — the system auto-switches on failure.
-**View and switch:**
-```
-/model                          — list all providers and models
-/model 1                        — switch to provider #1
-/model openrouter               — switch by provider name
-/model openrouter anthropic/claude-sonnet-4   — change model within provider
-```
-**Add providers:**
-```
-/setup                          — main menu (all categories)
-/setup free                     — free providers only
-/setup local                    — local (Ollama, LM Studio)
-/setup paid                     — paid (OpenAI, DeepSeek, Anthropic)
-/setup router                   — routers (OpenRouter — 200+ models)
-/setup add 2 API_KEY            — add provider #2 with key
-/setup remove 2                 — remove provider #2
-```
-**Test connectivity:**
-```
-/providers test                 — ping all providers with latency
-```
----
-### Free Providers
-| Provider | Models | Key | Register | Speed |
-|----------|--------|-----|----------|-------|
-| 🇷🇺 **ZAI (GLM)** | glm-4.7-flash, glm-5-turbo, **glm-5.1** | `ZAI_API_KEY` | [open.bigmodel.cn](https://open.bigmodel.cn/) | ~15s (reasoning) |
-| 🏠 **Ollama** | qwen2.5:7b, llama3, any local | None needed | `ollama pull qwen2.5:7b` | ~1-2s |
-| 🌐 **Google Gemini** | gemini-2.5-flash-lite | `GEMINI_API_KEY` | [aistudio.google.com](https://aistudio.google.com/apikey) | ~3s |
-| ⚡ **Groq** | llama-3.3-70b, mixtral | `GROQ_API_KEY` | [console.groq.com](https://console.groq.com/keys) | ~1s |
-| 🚀 **Cerebras** | llama-3.3-70b | `CEREBRAS_API_KEY` | [cloud.cerebras.ai](https://cloud.cerebras.ai) | ~0.5s |
-| 🇨🇳 **Qwen/DashScope** | qwen-plus, qwen-max | `DASHSCOPE_API_KEY` | [dashscope.console.aliyun.com](https://dashscope.console.aliyun.com/) | ~3s |
----
-### Key Features
-#### Multi-Provider Fallback Chain
-If the current provider fails, times out, or returns an error, FreeClaude automatically switches to the next one by priority (`priority` field in config, 1 = highest). Your workflow is never interrupted.
-#### GBrain Semantic Memory
-Cross-session memory using local embeddings. Store facts about your project (`/remember`), retrieve them semantically (`/recall`), and list (`/memories`) or delete (`/forget`) them. No need to re-explain your stack every session.
-#### Voice Mode
-Speech-to-text via OpenAI Whisper, text-to-speech via Microsoft Edge TTS. Free and local. Speak your requests instead of typing.
-#### Background Agents
-Run AI tasks in the background while you keep coding. Check results later with `/jobs` and `/job <id>`.
-#### Hook System (26 event types)
-5 pre-configured safety hooks: prevent secret commits, block `rm -rf`, auto-format check, git commit tracking, long-task notifications. Extend with custom hooks.
-#### Cost Tracking
-Real-time cost tracking per session, day, week, and month. Works with all providers that report token usage.
-#### Git Integration
-AI-powered commits (`/commit`), diff viewing (`/diff`), safe rollback (`/undo N`), and repo structure overview (`/repo-map`).
----
-### Slash Commands
-| Command | Description |
-|---------|-------------|
-| `/model` | Switch provider/model |
-| `/setup` | Add/remove providers |
-| `/commit` | AI commit with diff analysis |
-| `/diff` | View unstaged changes |
-| `/undo [N]` | Rollback last N commits (soft reset) |
-| `/repo-map` | Repository structure overview |
-| `/providers test` | Ping all providers with latency |
-| `/cost` | Cost stats (today/week/month) |
-| `/remember <key> <value>` | Save fact to memory |
-| `/recall <key>` | Search memory |
-| `/forget <key>` | Delete from memory |
-| `/memories` | List all saved facts |
-| `/run <task>` | Run background AI task |
-| `/jobs` | List background tasks |
-| `/job <id>` | Background task result |
-| `/hooks` | Manage hooks |
-| `/memory` | Edit CLAUDE.md files |
-| `/status` | Current session and provider |
-| `/daily` | Daily summary |
----
-### MCP Servers
-#### CEOClaw PM — Project Management
-EVM-powered project management with 7 tools: create/list projects, create/update tasks, EVM metrics (CPI, SPI, EAC), and a status dashboard.
-```bash
-cd mcp-servers/ceoclaw-pm && npm install && npm start
-```
-#### 1С OData — 1C:Enterprise Data Access
-Read-only access to 1C via OData protocol. Compatible with Альфа-Авто, БАЗИС, ERP, Бухгалтерия, and any custom config with OData enabled.
-```bash
-cd mcp-servers/onec-odata && npm install && npm start
-```
-Config: `~/.freeclaude/onec-config.json`
----
-### Comparison with Competitors
+### Free Providers (No API Key Needed)
-| Feature | FreeClaude | Claude Code | Cline | Aider |
-|---------|-----------|-------------|-------|-------|
-| **Price** | 🆓 Free | $20/mo | Free | Free |
-| **Fallback Chain** | ✅ Auto | ❌ | ❌ | ❌ |
-| **Semantic Memory** | ✅ GBrain | ❌ | ❌ | ❌ |
-| **Voice Mode** | ✅ Free | 🔒 Paid | ❌ | ❌ |
-| **PM Tools (EVM)** | ✅ MCP | ❌ | ❌ | ❌ |
-| **1C Integration** | ✅ OData MCP | ❌ | ❌ | ❌ |
-| **Hooks** | ✅ 26 types | Partial | ❌ | ❌ |
-| **Desktop App** | ✅ Tauri | ❌ | ❌ | ❌ |
-| **Providers** | 19+ | 1 (Anthropic) | 15+ | 10+ |
+- **ZAI (GLM-4.7-Flash)** — [Get API Key](https://open.bigmodel.cn/)
+- **Ollama (Local)** — `ollama pull qwen2.5:3b`
+- **Google Gemini** — [Get API Key](https://aistudio.google.com/)
 ---
 ## 📄 License
-MIT — use freely, contributions welcome.
+MIT — use freely, contribute welcome.
 ---