@kernelonpanic/kitcode 1.2.8 → 1.3.0

package/README.md

@@ -109,7 +109,8 @@ Press `/` to open the command list.
 | `/provider` | Switch providers. |
 | `/login` · `/logout [provider]` | Add a provider or choose exactly which provider to remove. |
 | `/key [provider]` | Change API key for a provider. |
-| `/effort` · `/thinking` | Configure reasoning depth and output. |
+| `/effort [auto|low|medium|high|xhigh|max]` · `/thinking` | Select reasoning effort and configure reasoning output. |
+| `/memory show` · `/memory set <text>` · `/memory clear` | View, replace, or clear this project's persistent notes. |
 | `/resume` · `/clear` | Resume a session or start a new one. |
 | `/sessions` | Search sessions, then resume, rename, delete, or export one. |
 | `/sessions list` | List all saved sessions. |
@@ -171,6 +172,44 @@ Before the built-in `write` and `edit` tools change a file, KitCode creates a pr
 After a message changes files, KitCode detects common project checks such as `lint`, `typecheck`,
 and `test`. The exact commands are shown for approval before they run.
 
+## Reasoning effort
+
+Use `/effort` to open the picker or `/effort high` to choose a level directly. The command shows
+both the selected level and the value KitCode will send to the API for the current conversation.
+This confirms request encoding, not whether a gateway honors the parameter.
+
+`auto` uses `medium` for short general requests and `high` for long requests or messages containing
+coding-task keywords. It is a local heuristic, not a model-based difficulty assessment. Manual
+levels bypass this heuristic. For the original GPT-5, GPT-5.1 and o-series, KitCode maps `xhigh`
+and `max` to `high`; for GPT-5.2–5.4, it maps `max` to `xhigh`. It omits effort for unrecognized
+OpenAI-compatible model names. The Anthropic adapter sends the resolved level in `output_config`.
+Supported levels and their effect depend on the model and provider.
+
+## Project memory
+
+Project notes persist across chats, `/clear`, and restarts. Manage them with:
+
+```text
+/memory show
+/memory set Run npm test before committing. Put changelogs only in GitHub Releases.
+/memory clear
+```
+
+`set` replaces the whole note; `clear` asks for confirmation. Notes are limited to 16,000 characters
+and stored under `~/.kitcode/memory/`, separately for each canonical workspace path.
+
+The agent can also use the `memory` tool to read, add, replace, or delete notes. Mutations require
+a source, such as a user instruction or file/tool evidence. Updates appear in the tool transcript
+with a diff. Exact-match replacement and deletion help avoid overwriting unrelated notes.
+The tool is allowed by default in normal and accept modes; set `permissions.memory` to `ask` or
+`deny` to restrict it. Plan mode blocks the tool, including its read action.
+
+The agent is instructed to retain confirmed project facts, explicit preferences and accepted
+decisions, and to verify potentially stale notes against current files. Temporary progress belongs
+in the conversation. Secret-pattern redaction is best effort; do not put credentials in memory.
+Context compaction separately asks the model to preserve requirements, evidence, verification
+commands and outcomes, assumptions, and remaining work. Generated summaries can still omit details.
+
 ## Configuration
 
 KitCode uses these main paths:

package/README.ru.md

@@ -109,7 +109,8 @@ http://localhost:11434/v1
 | `/provider` | Переключить провайдера. |
 | `/login` · `/logout [provider]` | Добавить провайдера или выбрать конкретный API для выхода. |
 | `/key [provider]` | Сменить ключ провайдера. |
-| `/effort` · `/thinking` | Настроить глубину и отображение reasoning. |
+| `/effort [auto|low|medium|high|xhigh|max]` · `/thinking` | Выбрать effort и настроить reasoning. |
+| `/memory show` · `/memory set <текст>` · `/memory clear` | Просмотреть, заменить или очистить постоянные заметки проекта. |
 | `/resume` · `/clear` | Восстановить сессию или начать новую. |
 | `/sessions` | Найти сессию и открыть, переименовать, удалить или экспортировать её. |
 | `/sessions list` | Показать все сохранённые сессии. |
@@ -170,6 +171,44 @@ scrollback терминала, поэтому историю можно плав
 ручные изменения. После правок KitCode определяет стандартные команды проекта — например `lint`,
 `typecheck` и `test` — и перед запуском показывает их для подтверждения.
 
+## Reasoning effort
+
+Откройте `/effort` для выбора в меню или используйте `/effort high`, чтобы задать уровень сразу.
+Команда показывает выбранный уровень и значение, которое KitCode отправит API для текущей переписки.
+Это проверяет кодирование запроса, но не гарантирует, что шлюз провайдера применит параметр.
+
+`auto` выбирает `medium` для коротких общих запросов и `high` для длинных сообщений или задач с
+признаками исправления, тестирования и реализации. Это локальная эвристика, а не оценка сложности
+моделью. Ручной уровень отключает эвристику. Для исходного GPT-5, GPT-5.1 и o-серии KitCode
+сводит `xhigh` и `max` к `high`; для GPT-5.2–5.4 `max` сводится к `xhigh`. Для неизвестных
+OpenAI-совместимых моделей параметр не отправляется. Anthropic получает выбранный уровень в
+`output_config`. Реальная поддержка зависит от модели и провайдера.
+
+## Память проекта
+
+Заметки проекта сохраняются между чатами, `/clear` и перезапусками:
+
+```text
+/memory show
+/memory set Запускать npm test перед коммитом. Ченджлог публиковать только в GitHub Release.
+/memory clear
+```
+
+`set` заменяет всю заметку; `clear` запрашивает подтверждение. Лимит — 16 000 символов. Файлы
+хранятся в `~/.kitcode/memory/`, отдельно для каждого канонического пути проекта.
+
+Агент тоже может использовать инструмент `memory`: читать, добавлять, заменять и удалять записи.
+Для изменений он обязан указать источник: инструкцию пользователя или подтверждение из файла либо
+инструмента. В транскрипте показывается diff. Точная замена и удаление защищают соседние записи.
+В обычном и accept-режимах инструмент разрешён по умолчанию. Ограничьте его через
+`permissions.memory` значением `ask` или `deny`. Plan-режим блокирует инструмент.
+
+Агент сохраняет подтверждённые факты проекта, явные предпочтения и принятые решения. Он должен
+проверять старые заметки по текущим файлам. Временный прогресс остаётся в переписке. Redaction
+секретов работает по известным шаблонам, поэтому ключи и пароли не записывайте. Сжатие контекста
+отдельно сохраняет требования, подтверждения, команды проверок и результаты, предположения и
+оставшуюся работу. Модель всё ещё может пропустить детали в автоматически созданной сводке.
+
 ## Конфигурация
 
 Основные файлы KitCode: