Установите. Подключите.
Продолжайте.

Qoopia — ваше пространство долговременной памяти агентов. Каждая установка хранит собственные заметки, знания, пространства агентов и историю.

Подписанные пакеты доступны для macOS на Apple Silicon и Linux x64. Скачать Qoopia.

Перед установкой: польза, требования и доступы

1. Установите своё пространство

macOS · Apple Silicon

Qoopia требует macOS 15 или новее на Apple Silicon. Mac с Intel и Windows не поддерживаются.

1. Скачайте DMG и сверьте его SHA-256 с контрольной суммой на странице выпуска.
2. Откройте DMG, перенесите Qoopia в «Программы» и запустите приложение.
3. Войдите через Google или почту. При входе по почте откройте ссылку подтверждения.

Обновление Qoopia на Mac

Если Qoopia уже установлена на Mac, один раз закройте её и замените Qoopia.app в «Программах». Папку Application Support и сохранённые данные не удаляйте. Так установится встроенное обновление: следующие версии ставятся через «Проверить обновления…» в меню Qoopia. Если закрыть окно, Qoopia продолжит работать в строке меню.

Linux · x64, glibc 2.34+

Распакуйте TAR.GZ. В полученной папке выполните:

./qoopia open

./qoopia open работает, пока открыт его терминал; сохранённая память остаётся и после закрытия. Чтобы Qoopia работала без терминала и сама запускалась после перезагрузки, остановите её (Ctrl+C) и установите как пользовательский сервис:

./qoopia service install --commit

На сервере без входа в рабочий стол выполните ещё loginctl enable-linger $USER, чтобы сервис запускался после перезагрузки. Проверка: systemctl --user status qoopia; отключение: ./qoopia service uninstall --commit.

Для Linux нужны x64, glibc 2.34 или новее и команда ps (пакет procps). Запускайте Qoopia от обычного пользователя, не от root.

На сервере или по SSH, если браузер открыть нельзя, ./qoopia open продолжает работать и показывает команду SSH-туннеля к дашборду. Одноразовый код для входа выдаст ./qoopia owner-login во втором терминале на том же компьютере.

Для этих пакетов не нужно устанавливать Bun, Docker или Ollama. Облачным функциям модели нужны интернет и действующая поддерживаемая подписка.

Используйте свой существующий сервер

Если у вас уже есть доступный сервер Qoopia, выберите его:

./qoopia use-server --url https://YOUR-SERVER --commit

Замените адрес на свой сервер. Команда выбирает одно пространство, а не синхронизирует две базы данных. Текущее пространство видно в боковой панели. На сервере нужно самостоятельно настроить HTTPS-доступ, управление процессом и резервное копирование.

2. Подключите агентов

В выбранном пространстве Qoopia откройте Подключения. Три независимые авторизации служат разным целям:

Claude Code / Codex

В «Подключениях» выберите клиент и права: чтение или чтение и добавление. Примените настройку и пройдите OAuth-вход клиента. Затем скопируйте запрос из карточки подключения и отправьте его в этом клиенте: первый вызов протокола Qoopia подтвердит подключение. Проверочный код не нужен. Локальная установка добавляет настройки; для другого компьютера откройте экспортированный файл .qoopia-connection в Qoopia на том компьютере.

Для автоматического сохранения контекста отдельно откройте «Настройки памяти сессий» в «Подключениях» и выберите Codex или Claude Code. Это устанавливает обработчики событий сессии. В Codex один раз подтвердите доверие в /hooks. На другом компьютере импортируйте файл .qoopia-memory. Он содержит секретный ключ: храните его только на своём устройстве. Одного MCP-подключения недостаточно для сохранения сессий.

Claude Desktop · macOS

Выберите Claude Desktop в «Подключениях». Примените локальный адаптер, откройте ссылку авторизации и разрешите доступ к своей установке. Перезапустите Claude Desktop и отправьте запрос из карточки подключения в настоящем чате: первый вызов протокола Qoopia подтвердит подключение. Адаптер хранит данные авторизации отдельно от конфигурации Claude.

Claude в браузере

Включите внешний доступ в «Подключениях» и подтвердите аккаунт. Qoopia подготовит HTTPS-адрес. Добавьте подключение через официальную форму Claude, разрешите доступ и проверьте его из Claude. Ваша установка должна оставаться в сети.

ChatGPT Web / Desktop

ChatGPT Web и Desktop на Mac последний раз прошли проверку с настоящим клиентом 15 сентября 2026 года (ChatGPT Pro): OAuth, подтверждение подключения, создание и чтение заметок, повторные запросы без дублей. С тех пор текущие согласие и автоматическое подтверждение подключения с настоящим аккаунтом ChatGPT повторно не проверялись. Добавьте HTTPS-адрес из «Подключений» и подтвердите доступ. Аккаунт должен разрешать пользовательские MCP-подключения. Qoopia пока нет в публичном каталоге. Работайте в обычном чате ChatGPT с выбранным плагином.

Веб-клиенты не могут обращаться к localhost. Управляемый внешний доступ делает работающую установку доступной извне, но не копирует её память в общую облачную базу. Браузерный MCP не сохраняет автоматически весь разговор и события сессии.

Другие MCP-клиенты

Владелец или управляющий создаёт отдельную учётную запись агента с нужными разрешениями. Укажите адрес MCP и эту учётную запись в своей среде. Настройка и сохранение сессий зависят от клиента; универсального автоматического захвата нет.

Проверьте подключение целиком

1. Попросите агента сохранить короткую тестовую заметку без личных данных.
2. Попросите его найти эту заметку.
3. Убедитесь, что выбраны нужное пространство и нужный агент.

«Разрешение сохранено» означает, что доступ разрешён. Это не подтверждает успешный вызов инструмента памяти удалённым клиентом.

3. Учитывайте границы доступа

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

У каждого агента своя учётная запись и разрешения. Управляющий — это агент, которому вы доверили управление пространством. Эта роль не создаёт и не запускает постоянный ИИ-процесс. Тот же агент может представлять вас в Мостах.

Вход обслуживается отдельным сервисом идентификации. Ознакомьтесь с актуальной информацией о приватности при входе. Скачивания установщиков через qoopia.ai/download считаются на нашем сервере при переходе на GitHub: только платформа, версия и тип источника перехода, без cookies, сохранённого идентификатора и IP. Остальная аналитика сайта (просмотры страниц, язык, размер экрана и базовые показатели скорости) выключена, пока вы не включите её внизу страницы. Ни то, ни другое не включает содержимое вашей памяти и сообщений. Do Not Track и Global Privacy Control отключают и то, и другое.

4. Делитесь через Мосты

1. Создайте мост и приглашение. Отправьте его только нужному участнику.
2. Участник запросит доступ из своей установки. Подтвердите его в разделе «Участники».
3. Подготовьте отдельную копию в разделе К отправке. Опубликуйте название и краткое описание в каталоге группы.
4. Подтверждённый участник запрашивает конкретную версию. Выберите Разрешить отправку или Пропустить. Автоматическая отправка включается отдельно для конкретной версии и группы.
5. Копия поступает в раздел Полученное. Она не добавляется автоматически в основную память, не устанавливается как навык и не пересылается дальше.

Для доставки обе установки должны быть одновременно доступны. Полученные копии нельзя отозвать. Ограничения пилота: 32 записи участников на группу, 100 записей каталога и 1 МиБ на материал. Общего открытого хранилища личных заметок нет.

5. Что получают ваши агенты

• Каноны: Короткие правила для всего пространства, одного агента или одного проекта. Qoopia добавляет постоянные каноны в начале сессии, а подходящие — к каждому запросу; клиенты без хуков вызывают canon_match. Каноны пространства и проектов пишут управляющий агент и владелец, агент может написать свои, а страница «Канон» показывает их и позволяет снять ненужный.
• Ночной разбор: Агента ночного разбора назначает только владелец — в карточке агента или через agent_set_dreamer. Он читает разговоры пространства за выбранный период через session_review и может предлагать каноны; предложение становится каноном только после того, как владелец примет его в «Обзоре». Разбор запускается по расписанию самого агента. Остальные агенты видят только свои разговоры.
• Передача работы между Claude Code и Codex: Сессия Claude Code или Codex с памятью сессий, открывающая проект, получает последнюю работу другого агента того же владельца в нём: итоговый ответ, сводку, изменённые файлы, ошибки инструментов и последние запросы — как историю, а не как инструкции. Общий контекст должен быть включён. Клиенты без хуков вызывают work_handoff; work_take отмечает тему как взятую, пока отметка не истечёт или её не снимут, и ничего не блокирует.
• Инструменты: Подключённый клиент видит восемь основных инструментов: recall, note_get, note_create, agent_inbox, agent_send, qoopia_guide, tool_search и qoopia_execute, а для старых подключений ещё qoopia_protocol. tool_search находит остальные инструменты и возвращает их схемы. qoopia_execute выполняет короткий скрипт только для чтения в изолированной песочнице QuickJS с правами самого агента, в пределах 10 секунд, 50 вызовов инструментов и 20 КБ вывода; писать он не может и модель не использует.
• Поиск: По умолчанию recall отвечает без модели. С judge: true подписка модели памяти может расширить запрос и оценить найденное в пределах model_budget_ms (1–45 секунд). Оператор сервера может настроить необязательный старый сервис реранкинга; по умолчанию он выключен, а при ошибке или тайм-ауте результаты сохраняют исходный порядок. Пакетам для Mac и Linux не нужен внешний сервис поиска.

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

• Не получается скачать: Используйте официальные ссылки на главной странице. Если загрузка не удалась, обновите страницу версии и попробуйте снова.
• Предупреждение о локальном адресе: облачным клиентам нужен доступный HTTPS-адрес, а не localhost.
• Не то пространство: перед сохранением проверьте адрес и выбранный сервер в боковой панели.
• Нет автоматической сводки: проверьте подписку на модель в разделе «Память» и доступный лимит.
• Старый интерфейс: обновите страницу после уведомления о новой версии. Сначала сохраните неотправленный текст.
• Самопроверка: выполните qoopia doctor: на Mac /Applications/Qoopia.app/Contents/Resources/bundle/qoopia doctor, на Linux ./qoopia doctor в папке пакета. Журналы лежат в ~/Library/Logs/Qoopia на Mac и в ~/.local/state/qoopia/logs на Linux.
• Не помогло: сообщите о проблеме на GitHub. Укажите версию, платформу и вывод doctor. Никогда не вставляйте токены, ключи и личные заметки.

Удаление Qoopia

Если вы подключали память сессий, сначала выполните qoopia memory-unlink --runtime claude_code --commit (или --runtime codex). Если Qoopia работает как служба, выполните qoopia service uninstall --commit. Затем остановите Qoopia: на Mac выберите «Выйти из Qoopia» в строке меню (если просто закрыть окно, Qoopia продолжит работать), на Linux остановите ./qoopia open клавишами Ctrl+C. Пока Qoopia работает, удаление останавливается с сообщением «Installation is busy». После этого выполните qoopia uninstall --commit; на Mac затем перенесите Qoopia.app в Корзину.

Удаление сохраняет память: ~/Library/Application Support/Qoopia на Mac, ~/.local/share/qoopia на Linux. Повторная установка её подхватит. Удаляйте эту папку только после резервной копии и только если память больше не нужна.

Официальная документация клиентов

• Claude: каталог и собственные коннекторы
• OpenAI: подключение собственной интеграции ChatGPT