Настройки предпочтений

Файл настроек хранит персональные параметры, которые настраивают взаимодействие агента с вами.

Расположение

~/.craft-agent/preferences.json

Структура

{
  "name": "Alex",
  "timezone": "America/New_York",
  "location": {
    "city": "New York",
    "region": "New York",
    "country": "USA"
  },
  "notes": "I prefer concise responses",
  "includeCoAuthoredBy": true,
  "updatedAt": 1737451800000
}

Поля

name

Ваше имя или как вы хотели бы быть обращённым.

"name": "Alex"

Агент может использовать это в приветствиях или персонализированных ответах.

timezone

Ваш часовой пояс в формате IANA.

"timezone": "America/New_York"

Используется для:

• Точных ссылок на даты/время ("сегодня", "на этой неделе")
• Доступа к ежедневным заметкам
• Сроков выполнения задач

Распространённые значения:

• America/New_York
• America/Los_Angeles
• Europe/London
• Europe/Berlin
• Asia/Tokyo
• Australia/Sydney

location

Ваше местоположение, хранится как вложенный объект с полями city, region и country:

"location": {
  "city": "New York",
  "region": "New York",
  "country": "USA"
}

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

updatedAt

Отметка времени (в миллисекундах) последнего обновления настроек. Устанавливается автоматически.

"updatedAt": 1737451800000

Язык

Язык управляется через Настройки > Внешний вид > Язык, а не через preferences.json.

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

Если ваш preferences.json всё ещё содержит поле language из предыдущей версии, оно безопасно игнорируется.

notes

Свободные заметки о ваших предпочтениях.

"notes": "I prefer bullet points over paragraphs. Technical background."

Эти заметки включаются в контекст агента и влияют на стиль ответов.

includeCoAuthoredBy

Управляет тем, добавляет ли агент трейлер Co-Authored-By: Craft Agent к коммитам git. По умолчанию true.

"includeCoAuthoredBy": false

Установите false, чтобы подавить трейлер соавтора Craft Agent во всех коммитах git. Изменения вступают в силу при следующей сессии.

Редактирование настроек

С помощью команды

> /prefs

Открывает интерактивный редактор ваших настроек.

Ручное редактирование

Отредактируйте файл напрямую:

nano ~/.craft-agent/preferences.json

Изменения вступают в силу при следующем диалоге (начните новую сессию или перезапустите приложение).

Как используются настройки

Настройки включаются в системный промпт, поэтому агент знает:

• Как к вам обращаться
• Ваше текущее время и часовой пояс
• Где вы находитесь
• На каком языке отвечать (из Настройки > Внешний вид > Язык)
• Включать ли трейлер соавтора в коммиты git

Этот контекст делает ответы более релевантными и персонализированными.

Пример

{
  "name": "Jordan",
  "timezone": "Europe/Berlin",
  "location": {
    "city": "Berlin",
    "region": "Berlin",
    "country": "Germany"
  },
  "notes": "Software engineer. Prefer code examples over descriptions. Use metric units."
}

С этими настройками агент будет:

• Использовать берлинское время для ссылок на расписание
• Отвечать на языке, выбранном в настройках внешнего вида
• Отдавать предпочтение показу кода
• Использовать километры, градусы Цельсия и т.д.