В модуле проектов предусмотрена функция автозагрузки. Список файлов доступен в системе управления версиями. Для этого в параметрах настройки должна быть включена автоматическая загрузка репозиториев для соответствующей системы управления версиями (по умолчанию — включена):

Достаточно просто создать файл .kateproject в корневой папке проекта. Например, для проекта «Kate» файл .kateproject будет выглядеть следующим образом:

{
  "name": "Kate",
  "files": [
    {
      "git": 1
    }
  ]
}

Содержимое файла написано с помощью синтаксиса JSON. Название проекта — «Kate», и файлы, содержащиеся в нём, должны быть прочитаны из Git.

Вместо git также допустимо использовать subversion (svn) или mercurial (hg). Если выполнять чтение файлов из системы управления версиями не требуется, можно просто вызвать Kate из командной строки:

kate /path/to/folder

или следующим образом указать программе рекурсивно загружать файлы из каталогов:

{
  "name": "Kate",
  "files": [
    {
      "directory": "kate",
      "filters": [
        "*.cpp",
        "*.h",
        "*.ui",
        "CMakeLists.txt",
        "Find*.cmake"
      ],
      "recursive": 1,
      "hidden": 1
    }
  ],
  "exclude_patterns" : [
    "^build/.*"
  ]
}

Здесь вложенные папки и фильтры определяют, что является частью проекта. Также можно совместить управление версиями и управление файлами на основе фильтров. Получение скрытых файлов не будет выполняться, если опция "hidden" установлена в значение «0». "exclude_patterns" — список шаблонов регулярных выражений, которые можно использовать для исключения папок и файлов из иерархии проекта. В рассматриваемом примере будет исключены все файлы и папки в каталоге build корневого каталога.

Если требуется добавить поддержку сборки, можно создать такой файл .kateproject:

{
  "name": "Kate",
  "files": [
    {
      "git": 1
    }
  ],
  "build": {
    "directory": "build",
    "build": "make all",
    "clean": "make clean",
    "install": "make install",
    "targets": [
      {
        "name": "all",
        "build_cmd": "ninja"
        "run_cmd": "./bin/kate"
      },
      {
        "name": "kate",
        "build_cmd": "ninja kate-bin"
      }
    ]
  }
}

Указанные выше цели затем появятся в Модуле сборки в разделе «Цели, созданные модулем». Если указан массив "targets", то "build", "clean" и "install" игнорируются. Каждый элемент массива указывает цель. "name" представляет собой имя цели, "build_cmd" используется для сборки цели, а "run_cmd" — для запуска цели. Важнее всего "directory" — это место выполнения команд.

Если файл .kateproject отслеживается системой управления версиями, но возникла необходимость изменить конфигурацию для определённого рабочего места, необходимые изменения возможно сохранить в отдельном файле с именем .kateproject.local. Содержимое этого файла будет приоритетнее содержимого файла .kateproject.