Файл конфигурации

Основной файл конфигурации хранит список вашых workspace-ов, LLM-подключения и глобальные настройки приложения.

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

~/.craft-agent/config.json

Структура

{
  "llmConnections": [
    {
      "slug": "anthropic-api",
      "name": "Anthropic (API Key)",
      "providerType": "anthropic",
      "authType": "api_key",
      "defaultModel": "claude-sonnet-4-6",
      "createdAt": 1737451800000
    }
  ],
  "defaultLlmConnection": "anthropic-api",
  "workspaces": [
    {
      "id": "ws-abc123",
      "name": "Personal Notes",
      "rootPath": "/path/to/workspace",
      "createdAt": 1737451800000
    }
  ],
  "activeWorkspaceId": "ws-abc123",
  "activeSessionId": "260121-swift-falcon",
  "notificationsEnabled": true,
  "colorTheme": "default"
}

Поля

llmConnections

Массив конфигураций LLM-подключений. Каждое подключение представляет собой настройку провайдера (Anthropic, Codex/OpenAI, OpenRouter и т.д.).

Подробнее о схеме и примерах см. в разделе LLM Connections.

defaultLlmConnection

Slug LLM-подключения по умолчанию, используемого для новых сессий (если не переопределён на уровне workspace). Если не указан, используется первое подключение из llmConnections.

workspaces

Массив настроенных workspace-ов. Каждый workspace представляет собой директорию или контекст проекта.

{
  "id": "ws-abc123",
  "name": "Personal Notes",
  "rootPath": "/Users/alex/projects/notes",
  "createdAt": 1737451800000,
  "lastAccessedAt": 1737538200000
}

activeWorkspaceId

ID текущего активного workspace, или null, если workspace не выбран. Определяет контекст workspace, используемый при запуске AIKraft Agents.

activeSessionId

ID текущей активной сессии внутри активного workspace, или null, если сессия не выбрана.

notificationsEnabled

Включение или отключение настольных уведомлений о событиях завершения задач. По умолчанию: true.

colorTheme

ID выбранной темы-пресета (например, "dracula", "nord"). По умолчанию: "default".

Для локальных настроек темы используйте defaults.colorTheme в конфигурации каждого workspace. Подробнее в разделе Workspaces.

dismissedUpdateVersion

Строка версии обновления, которое пользователь отклонил. Приложение больше не будет предлагать обновиться до этой конкретной версии.

pendingUpdate

Объект с информацией об обновлении, готовом к автоматической установке при следующем запуске:

{
  "version": "0.3.0",
  "installerPath": "/path/to/installer",
  "sha256": "abc123..."
}

Пример конфигурации

Для современной настройки с несколькими провайдерами используйте llmConnections вместе с defaultLlmConnection. Пример:

{
  "llmConnections": [
    {
      "slug": "anthropic-api",
      "name": "Anthropic (API Key)",
      "providerType": "anthropic",
      "authType": "api_key",
      "defaultModel": "claude-sonnet-4-6",
      "createdAt": 1737451800000
    },
    {
      "slug": "codex",
      "name": "OpenAI (Codex)",
      "providerType": "openai",
      "authType": "oauth",
      "defaultModel": "codex-mini-latest",
      "createdAt": 1737451800000
    }
  ],
  "defaultLlmConnection": "anthropic-api",
  "workspaces": [...],
  "activeWorkspaceId": "ws-personal"
}

Автоматические резервные копии

При запуске AIKraft Agents создаёт снимок существующего config.json в файл с датой рядом с ним, прежде чем какой-либо код изменит реестр workspace-ов. Это обеспечивает восстановимую копию в случае сбоя или случайного сброса конфигурации.

~/.craft-agent/
├── config.json
├── config.json.bak-2026-06-20
├── config.json.bak-2026-06-21
└── config.json.bak-2026-06-22

Поведение:

• Одна резервная копия в день, названная config.json.bak-YYYY-MM-DD.
• Сохраняются 3 самые последние резервные копии; более старые удаляются автоматически.
• Первый запуск в течение дня создаёт снимок. Последующие запуски в тот же день не перезаписывают его, поэтому датированная резервная копия всегда содержит состояние до изменений.
• Резервные копии создаются по принципу «best-effort». Если запись не удалась, ошибка логируется, и запуск продолжается нормально.

Чтобы восстановить резервную копию, закройте AIKraft Agents, затем скопируйте датированный файл поверх config.json:

cp ~/.craft-agent/config.json.bak-2026-06-21 ~/.craft-agent/config.json

Изменение конфигурации

Большинство настроек можно изменить через приложение:

Для расширенных изменений отредактируйте файл напрямую, когда AIKraft Agents не запущен.

Перед ручными правками создайте резервную копию файла конфигурации. Некорректный JSON не позволит AIKraft Agents запуститься.