@kernelonpanic/kitcode 1.2.9 → 1.3.1

package/README.md

@@ -109,7 +109,9 @@ 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. |
+| `/refresh [provider]` | Reload a provider's model list, bypassing the 24h cache. |
+| `/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. |
@@ -117,7 +119,7 @@ Press `/` to open the command list.
 | `/sessions delete <id>` | Delete a saved session. |
 | `/sessions delete all` | Delete every saved chat after two separate confirmations. |
 | `/sessions export <id> [path]` | Export a session to a private Markdown file (default: `.kitcode-exports/`). |
-| `/attach <path>` · `/attach clipboard` · `/attach clear` | Manage attachments for the next message. |
+| `/attach <path>` · `/attach clipboard` · `/attach clear` | Manage attachments for the next message; type `@` in the prompt to find and attach a workspace file. |
 | `/compact` | Replace older conversation context with a concise model-generated summary. |
 | `/update` | Check npm for a newer KitCode version. |
 | `/subagents` | Show the current number of active sub-agents. |
@@ -144,7 +146,7 @@ Press `/` to open the command list.
 | --- | --- |
 | `Enter` | Send a message or choose an item. |
 | `↑` / `↓` | Browse input history or menu items. |
-| `Tab` | Complete a slash command. |
+| `Tab` | Complete a slash command or selected `@` file. |
 | `Shift+Tab` | Cycle `normal → accept → plan`. |
 | `Ctrl+V` / `Cmd+V` | Attach an image from the system clipboard; `/attach clipboard` is the explicit fallback. |
 | `Esc` | Cancel the current request or close an overlay. |
@@ -171,6 +173,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,9 @@ http://localhost:11434/v1
 | `/provider` | Переключить провайдера. |
 | `/login` · `/logout [provider]` | Добавить провайдера или выбрать конкретный API для выхода. |
 | `/key [provider]` | Сменить ключ провайдера. |
-| `/effort` · `/thinking` | Настроить глубину и отображение reasoning. |
+| `/refresh [provider]` | Перечитать список моделей провайдера в обход суточного кеша. |
+| `/effort [auto|low|medium|high|xhigh|max]` · `/thinking` | Выбрать effort и настроить reasoning. |
+| `/memory show` · `/memory set <текст>` · `/memory clear` | Просмотреть, заменить или очистить постоянные заметки проекта. |
 | `/resume` · `/clear` | Восстановить сессию или начать новую. |
 | `/sessions` | Найти сессию и открыть, переименовать, удалить или экспортировать её. |
 | `/sessions list` | Показать все сохранённые сессии. |
@@ -117,7 +119,7 @@ http://localhost:11434/v1
 | `/sessions delete <id>` | Удалить сохранённую сессию. |
 | `/sessions delete all` | Удалить все сохранённые чаты после двух отдельных подтверждений. |
 | `/sessions export <id> [путь]` | Экспортировать сессию в приватный Markdown-файл (по умолчанию `.kitcode-exports/`). |
-| `/attach <путь>` · `/attach clipboard` · `/attach clear` | Управлять вложениями следующего сообщения. |
+| `/attach <путь>` · `/attach clipboard` · `/attach clear` | Управлять вложениями следующего сообщения; введите `@` в строке ввода для поиска и прикрепления файла проекта. |
 | `/compact` | Заменить старую часть контекста краткой сводкой модели. |
 | `/update` | Проверить новую версию KitCode в npm. |
 | `/subagents` | Показать текущее количество активных суб-агентов. |
@@ -143,7 +145,7 @@ http://localhost:11434/v1
 | --- | --- |
 | `Enter` | Отправить сообщение или выбрать пункт. |
 | `↑` / `↓` | Листать историю сообщений или пункты меню. |
-| `Tab` | Дополнить slash-команду. |
+| `Tab` | Дополнить slash-команду или выбранный файл после `@`. |
 | `Shift+Tab` | Переключить режим `normal → accept → plan`. |
 | `Ctrl+V` / `Cmd+V` | Прикрепить картинку из системного буфера; явный запасной вариант — `/attach clipboard`. |
 | `Esc` | Остановить текущий запрос или закрыть окно. |
@@ -170,6 +172,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: