Примеры использования¶

На этой странице собраны короткие практические сценарии. Для справочников смотрите команды, настройки и навыки агента.

Подключить MCP-сервер¶

Подкоманда koda mcp описана в аргументах CLI, конфигурация серверов — в настройках.

Пример stdio-сервера:

koda mcp add local-tools node ./mcp-server.js --scope project

Пример remote HTTP-сервера:

koda mcp add docs https://example.com/mcp \
  --transport http \
  --header "Authorization: Bearer ${MCP_TOKEN}" \
  --scope user

Проверка:

koda mcp list

Внутри TUI:

/mcp list
/mcp refresh

Если MCP-сервер требует OAuth, используйте:

/mcp auth <server>

Предостережение

Прежде чем использовать сторонний сервер MCP, убедитесь, что вы доверяете его источнику и понимаете инструменты, которые он предоставляет. Вы используете сторонние серверы на свой страх и риск.

Создать проектную команду¶

Больше возможностей

Смотрите страницу о пользовательских слеш-командах.

mkdir -p .kodacli/commands/git

Файл .kodacli/commands/git/review.toml:

.kodacli/commands/git/review.toml

description = "Проверить staged diff"
prompt = """
Проанализируй staged changes, найди риски и предложи минимальные проверки.
"""

После перезапуска CLI команда будет доступна как:

/git:review

Включить память проекта¶

Создайте KODA.md или AGENTS.md в корне:

KODA.md

# Project Memory

- Используем Node.js 20.
- Перед PR запускаем `npm run build` и `npm test`.
- Не меняем публичные CLI flags без обновления документации.

Можно сгенерировать стартовый файл командой:

/init

Если вы используете AGENTS.md, добавьте его в настройки проекта:

{
  "contextFileName": ["KODA.md", "AGENTS.md"]
}

Подключить дополнительные каталоги¶

koda --include-directories ../shared,../docs

Или в настройках:

{
  "includeDirectories": ["../shared", "../docs"]
}

Это расширяет рабочую область для чтения файлов и загрузки памяти. Для управления памятью из этих каталогов есть настройка loadMemoryFromIncludeDirectories.