npm - @kernelonpanic/kitcode - Versions diffs - 1.2.0 → 1.2.5 - Mend

@kernelonpanic/kitcode 1.2.0 → 1.2.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.ru.md CHANGED Viewed

@@ -1,276 +1,281 @@
-# KitCode
-[English](./README.md) · Русский
-```text
-  ╱\_╱\
- ( o.o )
-  > ^ <
-```
-KitCode — терминальный агент для работы с кодом. Он читает и изменяет файлы, ищет по проекту,
-запускает команды, подключает внешние инструменты через MCP и сохраняет историю сессий.
-Интерфейс построен на TypeScript, React и Ink. Поддерживаются Anthropic API и
-OpenAI-совместимые провайдеры, включая OpenRouter и локальные серверы.
-## Возможности
-- потоковые ответы и отображение reasoning;
-- чтение, создание и точечное редактирование файлов;
-- поиск по именам и содержимому файлов;
-- запуск shell-команд с подтверждением;
-- режимы `normal`, `accept` и `plan`;
-- продолжение и восстановление прошлых сессий с обычным scrollback терминала;
-- поиск по сессиям, переименование, удаление и экспорт в Markdown;
-- история введённых сообщений по клавишам `↑` и `↓`;
-- очередь сообщений, пока агент занят;
-- вложения PNG, JPEG, GIF, WebP и текстовых UTF-8 файлов;
-- ручное и автоматическое сжатие старого контекста;
-- индикатор токенов, стоимости, точного заполнения контекста и rate limits провайдера;
-- автоматические чекпоинты файлов и команда `/undo`;
-- автоматическое определение проверок проекта после правок;
-- переключение моделей и провайдеров из TUI;
-- добавление, включение, выключение и удаление MCP без перезапуска, skills и субагенты;
-- команда `/checker` для проверки runtime, провайдера, сессии, контекста и MCP;
-- русский и английский интерфейс, настраиваемый цвет темы.
-## Требования
-- Node.js 22 или новее;
-- npm.
-## Установка
-```sh
-npm i -g @kernelonpanic/kitcode
-```
-## Установка из исходников
-```sh
-git clone https://github.com/KernelEditor/KitCode.git
-cd KitCode
-npm install
-npm run build
-npm link
-```
-После `npm link` команда `kitcode` доступна глобально. Для запуска без глобальной установки:
-```sh
-npm run dev
-```
-## Первый запуск
-```sh
-kitcode
-```
-При первом запуске KitCode предложит выбрать язык, ввести базовый URL API и ключ. Затем он
-определит тип провайдера, загрузит доступные модели и откроет основное окно агента.
-Примеры базовых URL:
-```text
-https://api.anthropic.com
-https://openrouter.ai/api/v1
-http://localhost:11434/v1
-```
-## Командная строка
-| Команда | Назначение |
-| --- | --- |
-| `kitcode` | Запустить TUI в текущей директории. |
-| `kitcode -c` | Продолжить последнюю сессию этого проекта. |
-| `kitcode -r <id>` | Восстановить сессию по идентификатору. |
-| `kitcode --cwd <path>` | Использовать другую рабочую директорию. |
-| `kitcode --model <provider/model>` | Запуститься с выбранной моделью. |
-| `kitcode --mode <normal\|accept\|plan>` | Выбрать начальный режим работы. |
-| `kitcode sessions` | Показать сохранённые сессии. |
-| `kitcode ask "вопрос"` | Выполнить один запрос без TUI. |
-| `kitcode add <url>` | Добавить провайдер; ключ вводится в скрытом поле. |
-| `kitcode add <url> --key-env <name>` | Прочитать ключ из переменной окружения. |
-| `kitcode trust` | Включить конфиг и skills текущего проекта. |
-| `kitcode config` | Показать расположение конфига и ключей. |
-| `kitcode config --local` | Создать конфиг проекта `./kitcode.json`. |
-| `kitcode prompt list` | Показать сохранённые промты. |
-| `kitcode prompt rm <slug>` | Удалить сохранённый промт. |
-## Команды внутри TUI
-Нажмите `/`, чтобы открыть список команд.
-| Команда | Назначение |
-| --- | --- |
-| `/model` | Выбрать модель. |
-| `/provider` | Переключить провайдера. |
-| `/login` · `/logout [provider]` | Добавить провайдера или выбрать конкретный API для выхода. |
-| `/key [provider]` | Сменить ключ провайдера. |
-| `/effort` · `/thinking` | Настроить глубину и отображение reasoning. |
-| `/resume` · `/clear` | Восстановить сессию или начать новую. |
-| `/sessions` | Найти сессию и открыть, переименовать, удалить или экспортировать её. |
-| `/sessions rename <id> <название>` | Переименовать сохранённую сессию. |
-| `/sessions delete all` | Удалить все сохранённые чаты после двух отдельных подтверждений. |
-| `/sessions export <id> [путь]` | Экспортировать сессию в приватный Markdown-файл (по умолчанию `.kitcode-exports/`). |
-| `/attach <путь>` · `/attach clipboard` · `/attach clear` | Управлять вложениями следующего сообщения. |
-| `/compact` | Заменить старую часть контекста краткой сводкой модели. |
-| `/subagents` | Показать текущее количество активных суб-агентов. |
-| `/undo` | Откатить встроенные правки файлов из последнего сообщения. |
-| `/usage` | Показать токены, запросы, стоимость, доступный баланс и rate limits, если API их отдаёт. |
-| `/checker` | Проверить настройку и список моделей без платного chat-запроса. |
-| `/prompt` | Вставить сохранённый промт. |
-| `/prompt save <name>` | Сохранить последнее сообщение как промт. |
-| `/skills` · `/mcp list` | Показать skills и состояние MCP. |
-| `/mcp add <имя> <url>` | Добавить и сразу подключить MCP-сервер. |
-| `/mcp enable <имя>` · `/mcp disable <имя>` | Подключить или отключить MCP без удаления. |
-| `/mcp delete <имя>` | Отключить и удалить MCP-сервер. |
-| `/theme` · `/lang` | Изменить тему или язык. |
-| `/config` | Показать активный конфиг. |
-| `/bypass` | Переключить работу без запросов подтверждения. |
-| `/help` · `/exit` | Показать помощь или выйти. |
-## Клавиши
-| Клавиша | Действие |
-| --- | --- |
-| `Enter` | Отправить сообщение или выбрать пункт. |
-| `↑` / `↓` | Листать историю сообщений или пункты меню. |
-| `Tab` | Дополнить slash-команду. |
-| `Shift+Tab` | Переключить режим `normal → accept → plan`. |
-| `Ctrl+V` / `Cmd+V` | Прикрепить картинку из системного буфера; явный запасной вариант — `/attach clipboard`. |
-| `Esc` | Остановить текущий запрос или закрыть окно. |
-Сообщения можно вводить, пока агент работает: они попадут в очередь и выполнятся по порядку.
-## Режимы
-- `normal` — изменения файлов, shell и MCP при необходимости запрашивают подтверждение;
-- `accept` — изменения файлов применяются автоматически;
-- `plan` — агент исследует проект и отвечает планом без изменений.
-Текущий режим, модель и usage отображаются в нижней панели, а заполняющаяся слева направо колба
-контекста — справа. До 60% она зелёная, затем жёлтая, а с 85% — красная. `ctx ?` означает, что
-провайдер ещё не вернул точный usage для текущей модели. Под колбой показывается количество
-подключённых MCP. Завершённый вывод переносится в обычный
-scrollback терминала, поэтому историю можно плавно листать даже во время потокового ответа.
-При достижении 80% известного окна KitCode автоматически сворачивает старые сообщения в сводку,
-оставляя последние два пользовательских хода. Команда `/compact` запускает это вручную.
-Перед изменением файла встроенными инструментами `write` и `edit` KitCode создаёт приватный
-чекпоинт. Команда `/undo` восстанавливает последний чекпоинт и не перезаписывает более свежие
-ручные изменения. После правок KitCode определяет стандартные команды проекта — например `lint`,
-`typecheck` и `test` — и перед запуском показывает их для подтверждения.
-## Конфигурация
-Основные файлы KitCode:
-| Путь | Содержимое |
-| --- | --- |
-| `~/.kitcode/config.json` | Глобальные настройки. |
-| `~/.kitcode/auth.json` | Ключи провайдеров. |
-| `~/.kitcode/sessions/` | Сохранённые сессии. |
-| `~/.kitcode/checkpoints/` | Автоматические чекпоинты для `/undo`. |
-| `~/.kitcode/prompts/` | Сохранённые промты. |
-| `~/.kitcode/skills/` | Глобальные skills. |
-| `./.kitcode/skills/` | Skills текущего проекта. |
-| `./kitcode.json` | Локальный конфиг проекта. |
-Минимальный пример ручной настройки провайдера:
-```json
-{
-  "version": 1,
-  "model": "openrouter/openai/gpt-5",
-  "providers": {
-    "openrouter": {
-      "type": "openai",
-      "baseUrl": "https://openrouter.ai/api/v1",
-      "keyEnv": "OPENROUTER_API_KEY"
-    }
-  }
-}
-```
-Основные параметры: `model`, `effort`, `thinking`, `maxTokens`, `budget`, `diagnostics`, `updates`,
-`theme`, `permissions`, `providers` и `mcp`. Секция `budget` задаёт лимиты запросов к модели, токенов,
-примерной стоимости (если провайдер сообщает цены) и субагентов на одно сообщение.
-`diagnostics.autoRun` включает проверки после правок, а `diagnostics.commands` позволяет заменить
-автоопределение списком до восьми команд. Проверка обновлений через GitHub подготовлена, но по
-умолчанию выключена: `updates.checkOnStart: false`; в таком состоянии сетевого запроса при старте
-нет. Обычно редактировать конфиг вручную не требуется —
-провайдер можно добавить при первом запуске или через `/login`.
-После проверки проекта включите его локальный конфиг и skills командой:
-```sh
-kitcode trust
-```
-Команда `kitcode trust --revoke` снова оставит для проекта только глобальные настройки и skills.
-## MCP и skills
-MCP поддерживает локальные `stdio`-серверы и удалённые HTTP-серверы. Ими можно управлять из TUI:
-```text
-/mcp add docs https://mcp.example.com/mcp
-/mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem .
-/mcp list
-/mcp disable filesystem
-/mcp enable filesystem
-/mcp delete filesystem
-```
-Серверы сохраняются в секции `mcp`:
-```json
-{
-  "mcp": {
-    "github": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-github"],
-      "env": {
-        "GITHUB_TOKEN": "${env:GITHUB_TOKEN}"
-      }
-    }
-  }
-}
-```
-Skill — это директория с файлом `SKILL.md`. Глобальные skills находятся в
-`~/.kitcode/skills`, проектные — в `./.kitcode/skills`.
-Во вложениях поддерживаются PNG, JPEG, GIF и WebP до 10 МБ, а также UTF-8 текст до 256 КБ.
-Если вставить или перетащить отдельный путь к существующему файлу, он автоматически появится
-чипом под полем ввода. Содержимое отправляется провайдеру только вместе со следующим сообщением.
-## Разработка
-```sh
-npm run dev        # запустить исходники через tsx
-npm run build      # собрать dist/index.js
-npm run typecheck  # проверить TypeScript
-npm test           # запустить тесты
-```
-Основные директории:
-```text
-src/app/        запуск приложения и runtime
-src/core/       цикл агента, сессии и usage
-src/providers/  Anthropic и OpenAI-совместимые адаптеры
-src/tools/      файловые, shell и служебные инструменты
-src/mcp/        MCP-клиент и адаптер инструментов
-src/ui/         TUI на Ink
-test/           тесты Vitest
-```
-## Лицензия
-MIT
+# KitCode
+[English](./README.md) · Русский
+```text
+  ╱\_╱\
+ ( o.o )
+  > ^ <
+```
+KitCode — терминальный агент для работы с кодом. Он читает и изменяет файлы, ищет по проекту,
+запускает команды, подключает внешние инструменты через MCP и сохраняет историю сессий.
+Интерфейс построен на TypeScript, React и Ink. Поддерживаются Anthropic API и
+OpenAI-совместимые провайдеры, включая OpenRouter и локальные серверы.
+## Возможности
+- потоковые ответы и отображение reasoning;
+- чтение, создание и точечное редактирование файлов;
+- поиск по именам и содержимому файлов;
+- запуск shell-команд с подтверждением;
+- режимы `normal`, `accept` и `plan`;
+- продолжение и восстановление прошлых сессий с обычным scrollback терминала;
+- поиск по сессиям, переименование, удаление и экспорт в Markdown;
+- история введённых сообщений по клавишам `↑` и `↓`;
+- очередь сообщений, пока агент занят;
+- вложения PNG, JPEG, GIF, WebP и текстовых UTF-8 файлов;
+- ручное и автоматическое сжатие старого контекста;
+- индикатор токенов, стоимости, точного заполнения контекста и rate limits провайдера;
+- автоматические чекпоинты файлов и команда `/undo`;
+- автоматическое определение проверок проекта после правок;
+- переключение моделей и провайдеров из TUI;
+- добавление, включение, выключение и удаление MCP без перезапуска, skills и субагенты;
+- команда `/checker` для проверки runtime, провайдера, сессии, контекста и MCP;
+- русский и английский интерфейс, настраиваемый цвет темы.
+## Требования
+- Node.js 22 или новее;
+- npm.
+## Установка
+```sh
+npm i -g @kernelonpanic/kitcode
+```
+## Установка из исходников
+```sh
+git clone https://github.com/KernelEditor/KitCode.git
+cd KitCode
+npm install
+npm run build
+npm link
+```
+После `npm link` команда `kitcode` доступна глобально. Для запуска без глобальной установки:
+```sh
+npm run dev
+```
+## Первый запуск
+```sh
+kitcode
+```
+При первом запуске KitCode предложит выбрать язык, ввести базовый URL API и ключ. Затем он
+определит тип провайдера, загрузит доступные модели и откроет основное окно агента.
+Примеры базовых URL:
+```text
+https://api.anthropic.com
+https://openrouter.ai/api/v1
+http://localhost:11434/v1
+```
+## Командная строка
+| Команда | Назначение |
+| --- | --- |
+| `kitcode` | Запустить TUI в текущей директории. |
+| `kitcode -c` | Продолжить последнюю сессию этого проекта. |
+| `kitcode -r <id>` | Восстановить сессию по идентификатору. |
+| `kitcode --cwd <path>` | Использовать другую рабочую директорию. |
+| `kitcode --model <provider/model>` | Запуститься с выбранной моделью. |
+| `kitcode --mode <normal|accept|plan>` | Выбрать начальный режим работы. |
+| `kitcode sessions` | Показать сохранённые сессии. |
+| `kitcode ask "вопрос"` | Выполнить один запрос без TUI. |
+| `kitcode add <url>` | Добавить провайдера; ключ вводится в скрытом поле. |
+| `kitcode add <url> --key-env <name>` | Прочитать ключ из переменной окружения. |
+| `kitcode trust` | Включить конфиг и skills текущего проекта. |
+| `kitcode config` | Показать расположение конфига и ключей. |
+| `kitcode config --local` | Создать конфиг проекта `./kitcode.json`. |
+| `kitcode prompt list` | Показать сохранённые промты. |
+| `kitcode prompt rm <slug>` | Удалить сохранённый промт. |
+## Команды внутри TUI
+Нажмите `/`, чтобы открыть список команд.
+| Команда | Назначение |
+| --- | --- |
+| `/model` | Выбрать модель. |
+| `/provider` | Переключить провайдера. |
+| `/login` · `/logout [provider]` | Добавить провайдера или выбрать конкретный API для выхода. |
+| `/key [provider]` | Сменить ключ провайдера. |
+| `/effort` · `/thinking` | Настроить глубину и отображение reasoning. |
+| `/resume` · `/clear` | Восстановить сессию или начать новую. |
+| `/sessions` | Найти сессию и открыть, переименовать, удалить или экспортировать её. |
+| `/sessions list` | Показать все сохранённые сессии. |
+| `/sessions rename <id> <название>` | Переименовать сохранённую сессию. |
+| `/sessions delete <id>` | Удалить сохранённую сессию. |
+| `/sessions delete all` | Удалить все сохранённые чаты после двух отдельных подтверждений. |
+| `/sessions export <id> [путь]` | Экспортировать сессию в приватный Markdown-файл (по умолчанию `.kitcode-exports/`). |
+| `/attach <путь>` · `/attach clipboard` · `/attach clear` | Управлять вложениями следующего сообщения. |
+| `/compact` | Заменить старую часть контекста краткой сводкой модели. |
+| `/update` | Проверить новую версию KitCode в npm. |
+| `/subagents` | Показать текущее количество активных суб-агентов. |
+| `/undo` | Откатить встроенные правки файлов из последнего сообщения. |
+| `/usage` | Показать токены, запросы, стоимость, доступный баланс и rate limits, если API их отдаёт. |
+| `/checker` | Проверить настройку и список моделей без платного chat-запроса. |
+| `/prompt` | Вставить сохранённый промт. |
+| `/prompt save <name>` | Сохранить последнее сообщение как промт. |
+| `/prompt delete <name>` | Удалить сохранённый промт. |
+| `/skills` · `/mcp list` | Показать skills и состояние MCP. |
+| `/mcp add <имя> <url>` | Добавить и сразу подключить MCP-сервер. |
+| `/mcp add <имя> -- <команда> [аргументы]` | Добавить и подключить локальный MCP-сервер. |
+| `/mcp enable <имя>` · `/mcp disable <имя>` | Подключить или отключить MCP без удаления. |
+| `/mcp delete <имя>` | Отключить и удалить MCP-сервер. |
+| `/theme` · `/lang` | Изменить тему или язык. |
+| `/config` | Показать активный конфиг. |
+| `/bypass` | Переключить работу без запросов подтверждения. |
+| `/help` · `/exit` | Показать помощь или выйти. |
+## Клавиши
+| Клавиша | Действие |
+| --- | --- |
+| `Enter` | Отправить сообщение или выбрать пункт. |
+| `↑` / `↓` | Листать историю сообщений или пункты меню. |
+| `Tab` | Дополнить slash-команду. |
+| `Shift+Tab` | Переключить режим `normal → accept → plan`. |
+| `Ctrl+V` / `Cmd+V` | Прикрепить картинку из системного буфера; явный запасной вариант — `/attach clipboard`. |
+| `Esc` | Остановить текущий запрос или закрыть окно. |
+Сообщения можно вводить, пока агент работает: они попадут в очередь и выполнятся по порядку.
+## Режимы
+- `normal` — изменения файлов, shell и MCP при необходимости запрашивают подтверждение;
+- `accept` — изменения файлов применяются автоматически;
+- `plan` — агент исследует проект и отвечает планом без изменений.
+Текущий режим, модель и usage отображаются в нижней панели, а заполняющаяся слева направо колба
+контекста — справа. До 60% она зелёная, затем жёлтая, а с 85% — красная. `ctx ?` означает, что
+провайдер ещё не вернул точный usage для текущей модели. Под колбой показывается количество
+подключённых MCP. Завершённый вывод переносится в обычный
+scrollback терминала, поэтому историю можно плавно листать даже во время потокового ответа.
+При достижении 80% известного окна KitCode автоматически сворачивает старые сообщения в сводку,
+оставляя последние два пользовательских хода. Команда `/compact` запускает это вручную.
+Перед изменением файла встроенными инструментами `write` и `edit` KitCode создаёт приватный
+чекпоинт. Команда `/undo` восстанавливает последний чекпоинт и не перезаписывает более свежие
+ручные изменения. После правок KitCode определяет стандартные команды проекта — например `lint`,
+`typecheck` и `test` — и перед запуском показывает их для подтверждения.
+## Конфигурация
+Основные файлы KitCode:
+| Путь | Содержимое |
+| --- | --- |
+| `~/.kitcode/config.json` | Глобальные настройки. |
+| `~/.kitcode/auth.json` | Ключи провайдеров. |
+| `~/.kitcode/sessions/` | Сохранённые сессии. |
+| `~/.kitcode/checkpoints/` | Автоматические чекпоинты для `/undo`. |
+| `~/.kitcode/prompts/` | Сохранённые промты. |
+| `~/.kitcode/skills/` | Глобальные skills. |
+| `./.kitcode/skills/` | Skills текущего проекта. |
+| `./kitcode.json` | Локальный конфиг проекта. |
+Минимальный пример ручной настройки провайдера:
+```json
+{
+  "version": 1,
+  "model": "openrouter/openai/gpt-5",
+  "providers": {
+    "openrouter": {
+      "type": "openai",
+      "baseUrl": "https://openrouter.ai/api/v1",
+      "keyEnv": "OPENROUTER_API_KEY"
+    }
+  }
+}
+```
+Основные параметры: `model`, `effort`, `thinking`, `maxTokens`, `budget` и `diagnostics`,
+`theme`, `permissions`, `providers` и `mcp`. Секция `budget` задаёт лимиты запросов к модели, токенов,
+примерной стоимости (если провайдер сообщает цены) и субагентов на одно сообщение.
+`diagnostics.autoRun` включает проверки после правок, а `diagnostics.commands` позволяет заменить
+автоопределение списком до восьми команд. При каждом входе KitCode проверяет новую версию в npm и,
+если она вышла, показывает команду обновления. `/update` повторяет проверку вручную.
+Обычно редактировать конфиг вручную не требуется —
+провайдер можно добавить при первом запуске или через `/login`.
+После проверки проекта включите его локальный конфиг и skills командой:
+```sh
+kitcode trust
+```
+Команда `kitcode trust --revoke` снова оставит для проекта только глобальные настройки и skills.
+## MCP и skills
+MCP поддерживает локальные `stdio`-серверы и удалённые HTTP-серверы. Ими можно управлять из TUI:
+```text
+/mcp add docs https://mcp.example.com/mcp
+/mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem .
+/mcp list
+/mcp disable filesystem
+/mcp enable filesystem
+/mcp delete filesystem
+```
+Серверы сохраняются в секции `mcp`:
+```json
+{
+  "mcp": {
+    "github": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_TOKEN": "${env:GITHUB_TOKEN}"
+      }
+    }
+  }
+}
+```
+Skill — это директория с файлом `SKILL.md`. Глобальные skills находятся в
+`~/.kitcode/skills`, проектные — в `./.kitcode/skills`.
+Во вложениях поддерживаются PNG, JPEG, GIF и WebP до 10 МБ, а также UTF-8 текст до 256 КБ.
+Если вставить или перетащить отдельный путь к существующему файлу, он автоматически появится
+чипом под полем ввода. Содержимое отправляется провайдеру только вместе со следующим сообщением.
+## Разработка
+```sh
+npm run dev        # запустить исходники через tsx
+npm run build      # собрать dist/index.js
+npm run typecheck  # проверить TypeScript
+npm test           # запустить тесты
+```
+Основные директории:
+```text
+src/app/        запуск приложения и runtime
+src/core/       цикл агента, сессии и usage
+src/providers/  Anthropic и OpenAI-совместимые адаптеры
+src/tools/      файловые, shell и служебные инструменты
+src/mcp/        MCP-клиент и адаптер инструментов
+src/ui/         TUI на Ink
+test/           тесты Vitest
+```
+## Лицензия
+MIT