nova

Документация

Nova помогает выбирать проекты Tilda для Claude, Codex и других программ на Mac. Добавьте ключи один раз, а затем переключайте проекты из строки меню. Здесь — инструкция от установки до первого подключения.

1. Установка

Системные требования

Установка по шагам

  1. Скачайте локальную тестовую сборку Nova (архив Nova.zip, около 380 КБ).
  2. Дважды нажмите на архив, чтобы распаковать его. Появится Nova.app.
  3. Перетащите Nova.app в папку «Программы» (Applications).
  4. Откройте Nova из папки «Программы». Значок появится в строке меню справа вверху.
Сборка подписана ad-hoc, а не через Apple Developer ID и не проверена нотарификацией Apple. При первом запуске macOS может написать, что приложение не удалось проверить. Тогда откройте Системные настройки → Конфиденциальность и безопасность, найдите Nova в списке заблокированных и нажмите «Открыть всё равно». Этот шаг нужен один раз.

Nova запросит доступ к защищённому хранилищу macOS («Связка ключей»), чтобы сохранить ключи Tilda. Разрешите его, иначе ключи не сохранятся.

Приветственный экран Nova
При первом запуске Nova покажет приветствие. Нажмите «Начать».

Общие настройки

В разделе «Общие» выбирается тема, включается запуск Nova при входе в систему и настраивается перезапуск программ после смены ключа.

Настройки Nova, раздел «Общие»
Раздел «Общие»: тема, запуск при входе в систему и перезапуск программ.

2. Первый запуск

Подготовьте API-ключ проекта Tilda. Nova предложит выбрать программы, добавить проект и перейти в меню подключений.

Шаг 1. Выберите программы

Nova ищет файлы настроек поддерживаемых программ на вашем Mac. Отметьте те, в которых хотите работать с Tilda. Список можно изменить позже. Чтобы добавить другую программу, нажмите «Своя программа», укажите путь к файлу настроек и выберите подходящий формат из списка.

Первый запуск: выбор программ
Шаг 1. Отметьте программы, к которым нужно подключать Tilda.

Шаг 2. Добавьте первый проект

Дайте проекту понятное имя и вставьте его API-ключ Tilda. Укажите срок действия для учёта в Nova или оставьте «Без срока». Это не продлевает ключ на стороне Tilda. Сам ключ сохранится в защищённом хранилище macOS («Связка ключей»).

Первый запуск: название проекта и ключ Tilda
Шаг 2. Название проекта, ключ и срок его действия.

Шаг 3. Готово

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

Первый запуск: всё готово
Шаг 3. Nova живёт в строке меню macOS.

3. Добавить ключи

  1. Нажмите значок Nova в строке меню и откройте окно настроек.
  2. В разделе «Проекты» добавьте проект и укажите его название.
  3. Вставьте API-ключ Tilda. Он сохранится в защищённом хранилище macOS.
  4. Повторите для каждого проекта, с которым работаете.
Ключи Nova хранятся в защищённом хранилище macOS. Для работы MCP ключ также записывается в конфиг выбранной программы. Резервные копии конфигов могут содержать ключи.
Настройки Nova, раздел «Проекты»
Раздел «Проекты»: ключ, срок действия и программы, где проект доступен.

4. Подключить программу

Проект выбирается отдельно для каждой программы:

  1. Откройте меню Nova и найдите нужную программу.
  2. Выберите проект, с которым она будет работать.
  3. Включите переключатель. Nova сохранит копию файла настроек и подставит ключ выбранного проекта.

Например, Codex может работать с одним проектом, а Claude — с другим. Чтобы сменить проект, выберите другой в меню соответствующей программы.

Если подключение Tilda ещё не настроено, откройте раздел «Программы» в настройках Nova и добавьте MCP-сервер для нужной программы. Nova запросит подтверждение перед записью. Свой сервер запускать не нужно: программы обращаются к серверу Tilda через интернет.

Название «Codex / ChatGPT» в текущей версии Nova относится к настройкам Codex. Оно не означает подключение ChatGPT в браузере или приложении ChatGPT.

Программу из дока можно перетащить прямо на карточку проекта. Nova подключит её к этому проекту.

Меню Nova: перетаскивание программы из дока на проект
Перетащите программу из дока на карточку проекта — Nova подключит её.
Меню Nova: подтверждение запуска проекта в Codex
Перед подключением Nova показывает проект и программу и запрашивает подтверждение запуска.
Меню Nova: выбор проекта для программы
Меню в строке меню: у каждой программы свой проект и свой переключатель.
Настройки Nova, раздел «Программы»
Раздел «Программы»: список программ, пути к их файлам настроек и добавление своих программ.

5. Вернуть прежние настройки

Чтобы выбрать конкретную копию, откройте «Бэкапы» в настройках Nova и нажмите «Восстановить» рядом с нужной версией.

Копия создаётся перед каждым изменением файла настроек. Старые копии Nova удаляет через 30 дней, но последняя копия каждой программы сохраняется всегда — так что откат остаётся возможным.

Восстанавливается весь файл настроек, а не только ключ Tilda. Более поздние ручные изменения могут быть отменены. Если в выбранной копии был ключ другого проекта, он тоже вернётся.
Настройки Nova, раздел «Бэкапы»
Раздел «Бэкапы»: история копий конфигов с кнопкой «Восстановить».
Меню Nova в тёмной теме
Меню в тёмной теме. Тема выбирается в разделе «Общие».

6. Синхронизация между Mac

Если Nova работает на нескольких Mac, проекты и их ключи можно перенести через зашифрованный файл nova-sync.nova в облачной папке. Облачный сервис видит только зашифрованные данные.

  1. Откройте раздел «Синхронизация» в настройках Nova и выберите место: iCloud Drive, Яндекс Диск, Google Диск или любая папка на Mac. Для облачных дисков Nova находит папку сама, если клиент диска установлен.
  2. Задайте пароль синхронизации. Он хранится в защищённом хранилище macOS каждого Mac.
  3. На втором Mac выберите ту же папку и введите тот же пароль. Проекты появятся после синхронизации.
Пароль синхронизации нельзя восстановить через облако. Если его потерять, зашифрованный файл не прочитать — сохраните пароль в надёжном месте. Ключи Tilda при этом остаются в защищённом хранилище macOS каждого Mac.
Настройки Nova, раздел «Синхронизация»
Раздел «Синхронизация»: облачная папка, пароль и дата последней синхронизации.

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

7. Если что-то не работает

Программа не видит новый ключ

Меню Nova: программы ждут перезапуска
Жёлтая точка и надпись «Перезапустите» — программа ждёт перезапуска, чтобы прочитать новый ключ.

Сохраните текущую работу и перезапустите программу, чтобы она прочитала новые настройки. Nova умеет автоматически перезапускать Claude Desktop и приложение Codex, если эта опция включена. Для терминальных инструментов, включая Claude Code, начните новую сессию.

Меню Nova: уведомления и история подключений
В панели уведомлений видны ошибки, запросы на перезапуск и история подключений и резервных копий.

Программа не найдена

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

Синхронизация не видит проекты с другого Mac

Проверьте, что на обоих Mac выбрана одна и та же папка и введён один и тот же пароль синхронизации. Если пароль не совпадает, файл не читается. Для облачного диска убедитесь, что файл nova-sync.nova загрузился на этот Mac.

Ошибка при сохранении ключа

Если Nova сообщает об ошибке доступа к хранилищу ключей, проверьте запрос доступа в системном окне macOS. Если ключ сохранился, но Tilda не принимает подключение, убедитесь, что он скопирован целиком и срок его действия не истёк.

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

8. Поддержка

Не нашли ответ в инструкции? Напишите нам. Форма откроет письмо в почтовой программе на вашем Mac, адресованное info@av-five.ru. Сайт сам ничего не отправляет и не сохраняет.

Не вставляйте в сообщение API-ключи Tilda и пароль синхронизации. Ключ достаточно назвать по имени проекта.

Если форма не открывается, напишите вручную на info@av-five.ru. Для письма нужна почтовая программа по умолчанию.