@kernelonpanic/kitcode 1.4.0 → 1.4.2

package/README.md

@@ -88,7 +88,7 @@ http://localhost:11434/v1
 | `kitcode -r <id>` | Resume a session by id. |
 | `kitcode --cwd <path>` | Use another working directory. |
 | `kitcode --model <provider/model>` | Start with a selected model. |
-| `kitcode --mode <normal|accept|plan>` | Select the initial agent mode. |
+| `kitcode --mode <normal\|accept\|plan>` | Select the initial agent mode. |
 | `kitcode sessions` | List saved sessions. |
 | `kitcode ask "question"` | Run one request without the TUI. |
 | `kitcode add <url>` | Add a provider; the key is entered in a hidden prompt. |
@@ -105,21 +105,22 @@ Press `/` to open the command list.
 
 | Command | Purpose |
 | --- | --- |
-| `/model` | Select a model. |
+| `/model [model]` | Select a model; a full or unambiguous partial id skips the 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. |
 | `/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. |
+| `/effort [auto\|low\|medium\|high\|xhigh\|max]` · `/thinking` | Select reasoning effort and configure reasoning output. |
+| `/bell [on\|off]` | Toggle the beep when a long answer finishes or a permission prompt appears. |
 | `/context [tokens]` | Show or set the model context window used by the meter and automatic compaction. |
 | `/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. |
-| `/sessions rename <id> <title>` | Give a saved session a title. |
+| `/sessions rename [id] <title>` | Give a saved session a title. |
 | `/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/`). |
+| `/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; 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. |
@@ -127,16 +128,18 @@ Press `/` to open the command list.
 | `/undo` | Undo built-in file edits from the latest message. |
 | `/usage` | Show tokens, requests, cost, balance/key limits, and response rate-limit headers when available. |
 | `/checker` | Check the local setup and provider model listing without sending a paid chat request. |
-| `/prompt` | Insert a saved prompt. |
-| `/prompt save <name>` | Save the latest message as a prompt. |
-| `/prompt delete <name>` | Delete a saved prompt. |
+| `/prompt [name]` | Insert a saved prompt. |
+| `/prompt save [name]` | Save the latest message as a prompt, or pick a recent one and name it. Asks before replacing. |
+| `/prompt delete [name]` | Delete a saved prompt. |
 | `/skills` | Show discovered skills. |
-| `/mcp add <name> <https://url>` | Add and connect a remote MCP server. |
-| `/mcp add <name> -- <command> [args]` | Add and connect a local MCP server. |
+| `/skills install <source>` | Install a skill from a GitHub URL, an npm package, or a local folder. |
+| `/skills remove [name]` | Remove an installed global skill. |
+| `/mcp add <name> [-H "Name: value"] <https://url>` | Add and connect a remote MCP server. |
+| `/mcp add <name> [-e KEY=value] -- <command> [args]` | Add and connect a local MCP server. |
 | `/mcp list` | Show configured MCP servers and connection status. |
 | `/mcp enable <name>` · `/mcp disable <name>` | Connect or disconnect an MCP server without removing it. |
 | `/mcp delete <name>` | Disconnect and remove an MCP server. |
-| `/theme` · `/lang` | Change the accent or interface language. |
+| `/theme [color]` · `/lang [en\|ru]` | Change the accent or interface language. |
 | `/config` | Show the active config. |
 | `/bypass` | Toggle approval-free operation. |
 | `/help` · `/exit` | Show help or quit. |
@@ -152,8 +155,8 @@ Press `/` to open the command list.
 | `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. |
 
-Messages entered while the agent is running are queued and processed in order. Status and settings
-commands — `/help`, `/usage`, `/context`, `/model`, `/effort`, `/thinking`, `/budget`, `/theme`,
+Messages entered while the agent is running are queued and processed in order; they are listed above the input, and ↑/↓ on an empty input pick one to edit. Status and settings
+commands — `/help`, `/usage`, `/context`, `/model`, `/effort`, `/thinking`, `/bell`, `/budget`, `/theme`,
 `/lang`, `/subagents`, `/config`, `/checker`, `/exit` — run immediately instead. Commands that
 change the running turn or the session (`/clear`, `/compact`, `/resume`, `/undo`, `/login`,
 `/provider`, `/logout`, `/key`, `/refresh`, `/mcp`, `/sessions`) wait for the turn to finish.
@@ -305,16 +308,19 @@ immediately without a restart:
 
 ```text
 /mcp add docs https://mcp.example.com/mcp
-/mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem .
+/mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem "C:\My Projects"
+/mcp add github -e GITHUB_TOKEN=${env:GITHUB_TOKEN} -- npx -y @modelcontextprotocol/server-github
+/mcp add search -H "Authorization: Bearer ${env:SEARCH_TOKEN}" https://mcp.example.com/mcp
 /mcp list
 /mcp disable filesystem
 /mcp enable filesystem
 /mcp delete filesystem
 ```
 
-The server is saved to the active config. Use `${env:NAME}` references in a manually configured
-`env` or `headers` object when a server needs a secret; this keeps the secret itself out of the
-config file:
+Quotes keep spaces in paths and values. `-e` sets environment variables for a local server and
+`-H` sets headers for a remote one; both go before the URL or command. The server is saved to the
+active config. Use `${env:NAME}` references for secrets, on the command line or in the config,
+so the secret itself never lands in the config file:
 
 ```json
 {
@@ -331,12 +337,29 @@ config file:
 }
 ```
 
-A skill is a directory containing a `SKILL.md` file. Global skills live in
-`~/.kitcode/skills`; project skills live in `./.kitcode/skills`.
+A skill is a directory containing a `SKILL.md` file, plus any scripts or reference files it uses.
+Global skills live in `~/.kitcode/skills`; project skills live in `./.kitcode/skills`. Install one
+without leaving the TUI:
 
-Attachments support PNG, JPEG, GIF, and WebP images up to 10 MB, plus UTF-8 text files up to
-256 KB. Pasting or dragging a standalone existing path queues it automatically and displays a
-chip below the prompt. File contents are sent only when the attachment is submitted with a message.
+```text
+/skills install https://github.com/anthropics/skills/tree/main/skills/pdf
+/skills install @scope/some-skill
+/skills install ./my-skill
+/skills remove pdf
+```
+
+The whole skill folder is copied (symlinks are skipped). A link to a repository with several skills
+lists them so you can pick one by its path.
+
+Attachments support PNG, JPEG, GIF, and WebP images up to 10 MB, plus UTF-8 (or UTF-16) text
+files up to 256 KB. Pasting or dragging a standalone existing path queues it automatically and
+displays a chip below the prompt. File contents are sent only when the attachment is submitted with
+a message. Large or very tall images are scaled down to fit the API limits.
+
+Writing `@path/to/file` in a message sends that workspace file along with it. Mentions never reach
+outside the workspace and never pick up credentials (`.env`, keys, `~/.ssh`): attach those
+explicitly with `/attach` if you really mean to. If the model refuses an image (for example, it has
+no vision), the image is removed from the conversation so the next message still goes through.
 
 ## Development
 

package/README.ru.md

@@ -89,7 +89,7 @@ http://localhost:11434/v1
 | `kitcode -r <id>` | Восстановить сессию по идентификатору. |
 | `kitcode --cwd <path>` | Использовать другую рабочую директорию. |
 | `kitcode --model <provider/model>` | Запуститься с выбранной моделью. |
-| `kitcode --mode <normal|accept|plan>` | Выбрать начальный режим работы. |
+| `kitcode --mode <normal\|accept\|plan>` | Выбрать начальный режим работы. |
 | `kitcode sessions` | Показать сохранённые сессии. |
 | `kitcode ask "вопрос"` | Выполнить один запрос без TUI. |
 | `kitcode add <url>` | Добавить провайдера; ключ вводится в скрытом поле. |
@@ -106,21 +106,22 @@ http://localhost:11434/v1
 
 | Команда | Назначение |
 | --- | --- |
-| `/model` | Выбрать модель. |
+| `/model [модель]` | Выбрать модель; полный или однозначный кусок id — без списка. |
 | `/provider` | Переключить провайдера. |
 | `/login` · `/logout [provider]` | Добавить провайдера или выбрать конкретный API для выхода. |
 | `/key [provider]` | Сменить ключ провайдера. |
 | `/refresh [provider]` | Перечитать список моделей провайдера в обход суточного кеша. |
-| `/effort [auto|low|medium|high|xhigh|max]` · `/thinking` | Выбрать effort и настроить reasoning. |
+| `/effort [auto\|low\|medium\|high\|xhigh\|max]` · `/thinking` | Выбрать effort и настроить reasoning. |
+| `/bell [on\|off]` | Включить/выключить сигнал о готовом долгом ответе и запросе разрешения. |
 | `/context [tokens\|auto]` | Показать или задать окно контекста модели для индикатора и автосжатия. |
 | `/memory show` · `/memory set <текст>` · `/memory clear` | Просмотреть, заменить или очистить постоянные заметки проекта. |
 | `/resume` · `/clear` | Восстановить сессию или начать новую. |
 | `/sessions` | Найти сессию и открыть, переименовать, удалить или экспортировать её. |
 | `/sessions list` | Показать все сохранённые сессии. |
-| `/sessions rename <id> <название>` | Переименовать сохранённую сессию. |
+| `/sessions rename [id] <название>` | Переименовать сохранённую сессию. |
 | `/sessions delete <id>` | Удалить сохранённую сессию. |
 | `/sessions delete all` | Удалить все сохранённые чаты после двух отдельных подтверждений. |
-| `/sessions export <id> [путь]` | Экспортировать сессию в приватный Markdown-файл (по умолчанию `.kitcode-exports/`). |
+| `/sessions export [id] [путь]` | Экспортировать сессию в приватный Markdown-файл (по умолчанию `.kitcode-exports/`). |
 | `/attach <путь>` · `/attach clipboard` · `/attach clear` | Управлять вложениями следующего сообщения; введите `@` в строке ввода для поиска и прикрепления файла проекта. |
 | `/compact` | Заменить старую часть контекста краткой сводкой модели. |
 | `/update` | Проверить новую версию KitCode в npm. |
@@ -128,15 +129,16 @@ http://localhost:11434/v1
 | `/undo` | Откатить встроенные правки файлов из последнего сообщения. |
 | `/usage` | Показать токены, запросы, стоимость, доступный баланс и rate limits, если API их отдаёт. |
 | `/checker` | Проверить настройку и список моделей без платного chat-запроса. |
-| `/prompt` | Вставить сохранённый промт. |
-| `/prompt save <name>` | Сохранить последнее сообщение как промт. |
-| `/prompt delete <name>` | Удалить сохранённый промт. |
+| `/prompt [имя]` | Вставить сохранённый промт. |
+| `/prompt save [имя]` | Сохранить последнее сообщение как промт или выбрать одно из недавних и назвать. Спросит перед заменой. |
+| `/prompt delete [имя]` | Удалить сохранённый промт. |
 | `/skills` · `/mcp list` | Показать skills и состояние MCP. |
-| `/mcp add <имя> <url>` | Добавить и сразу подключить MCP-сервер. |
-| `/mcp add <имя> -- <команда> [аргументы]` | Добавить и подключить локальный MCP-сервер. |
+| `/skills install <источник>` · `/skills remove [имя]` | Установить skill (GitHub, npm, локальная папка) или удалить установленный. |
+| `/mcp add <имя> [-H "Имя: значение"] <url>` | Добавить и сразу подключить MCP-сервер. |
+| `/mcp add <имя> [-e КЛЮЧ=значение] -- <команда> [аргументы]` | Добавить и подключить локальный MCP-сервер. |
 | `/mcp enable <имя>` · `/mcp disable <имя>` | Подключить или отключить MCP без удаления. |
 | `/mcp delete <имя>` | Отключить и удалить MCP-сервер. |
-| `/theme` · `/lang` | Изменить тему или язык. |
+| `/theme [цвет]` · `/lang [en\|ru]` | Изменить тему или язык. |
 | `/config` | Показать активный конфиг. |
 | `/bypass` | Переключить работу без запросов подтверждения. |
 | `/help` · `/exit` | Показать помощь или выйти. |
@@ -152,9 +154,9 @@ http://localhost:11434/v1
 | `Ctrl+V` / `Cmd+V` | Прикрепить картинку из системного буфера; явный запасной вариант — `/attach clipboard`. |
 | `Esc` | Остановить текущий запрос или закрыть окно. |
 
-Сообщения можно вводить, пока агент работает: они попадут в очередь и выполнятся по порядку.
+Сообщения можно вводить, пока агент работает: они попадут в очередь и выполнятся по порядку. Очередь видна над полем ввода, а ↑/↓ в пустом поле выбирают сообщение для правки.
 Статусные команды и настройки — `/help`, `/usage`, `/context`, `/model`, `/effort`, `/thinking`,
-`/budget`, `/theme`, `/lang`, `/subagents`, `/config`, `/checker`, `/exit` — выполняются сразу.
+`/bell`, `/budget`, `/theme`, `/lang`, `/subagents`, `/config`, `/checker`, `/exit` — выполняются сразу.
 Команды, которые меняют текущий ход или сессию (`/clear`, `/compact`, `/resume`, `/undo`, `/login`,
 `/provider`, `/logout`, `/key`, `/refresh`, `/mcp`, `/sessions`), ждут завершения хода.
 
@@ -302,7 +304,8 @@ MCP поддерживает локальные `stdio`-серверы и уда
 
 ```text
 /mcp add docs https://mcp.example.com/mcp
-/mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem .
+/mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem "C:\Мои проекты"
+/mcp add github -e GITHUB_TOKEN=${env:GITHUB_TOKEN} -- npx -y @modelcontextprotocol/server-github
 /mcp list
 /mcp disable filesystem
 /mcp enable filesystem
@@ -329,9 +332,15 @@ MCP поддерживает локальные `stdio`-серверы и уда
 Skill — это директория с файлом `SKILL.md`. Глобальные skills находятся в
 `~/.kitcode/skills`, проектные — в `./.kitcode/skills`.
 
-Во вложениях поддерживаются PNG, JPEG, GIF и WebP до 10 МБ, а также UTF-8 текст до 256 КБ.
-Если вставить или перетащить отдельный путь к существующему файлу, он автоматически появится
-чипом под полем ввода. Содержимое отправляется провайдеру только вместе со следующим сообщением.
+Во вложениях поддерживаются PNG, JPEG, GIF и WebP до 10 МБ, а также текст в UTF-8 (или UTF-16)
+до 256 КБ. Если вставить или перетащить отдельный путь к существующему файлу, он автоматически
+появится чипом под полем ввода. Содержимое отправляется провайдеру только вместе со следующим
+сообщением. Большие или очень длинные картинки уменьшаются под лимиты API.
+
+`@путь/к/файлу` в сообщении отправляет этот файл проекта вместе с ним. Упоминания не выходят за
+пределы проекта и не подхватывают секреты (`.env`, ключи, `~/.ssh`) — такие файлы прикрепляются
+только явно через `/attach`. Если модель не принимает картинку (например, у неё нет зрения),
+картинка убирается из разговора, чтобы следующее сообщение прошло.
 
 ## Разработка