Об этом проекте

Textbutler — это находящийся в разработке AI-ассистент для выбранных вами бесед в iMessage, WhatsApp и Beeper на Mac. Включенный для одного контакта, он отвечает как явно помеченный помощник, знающий вашу историю общения с этим человеком. Не существует загружаемого приложения или опубликованного пакета Textbutler; он запускается из исходного кода. Без учетной записи AI вы все равно можете подключить мессенджеры через Ghostget, читать входящие и отправлять ответы, написанные вами самостоятельно. Для AI-ответов дополнительно требуются локальная сборка и подписка Claude Code или Codex, подключенная через xcb. Автоматические ответы в тестировании проекта работали сквозным образом через iMessage, но README рекомендует протестировать их на своей учетной записи, особенно через WhatsApp или Beeper, прежде чем полагаться на них. Настройка проходит через управляемый терминальный интерфейс (Bun 1.3.14): выберите Setup & readiness, затем Connect messaging apps. Новые установки начинаются в режиме паузы, и для новых контактов автоматические ответы отключены; настройка и выбор бесед никогда не отправляют сообщения. Компаньон в строке меню можно запускать, останавливать и регистрировать для автозапуска при входе, предлагая паузу, проверки подключения, выбор бесед, настройки контактов и агента, предпросмотр входящих и недавнюю активность. Удаление сохраняет настройки и память о контактах. Агенты могут использовать JSON CLI для перечисления бесед, чтения и обобщения истории, подготовки текстовых или медиа-черновиков и отправки явно авторизованного сообщения, используя те же поэтапные действия, что и ассистент. Ответы проходят этап проверки: предложения истекают через пятнадцать минут, а измененные настройки контакта, контекст или байты вложений требуют новой проверки. Каждый текстовый ответ обернут в три символа раскрытия контакта, по умолчанию отображаемые как 🤖{ … }; удаление всех трех отправляет обычный текст. Журнал отправки сохраняет идентификаторы подтверждения провайдера, а неуверенные отправки остаются заблокированными до сверки. Проект хранит контекст каждого контакта в файлах, которые вы можете читать и редактировать, по умолчанию помечает свои ответы и отвечает только после того, как вы включите контакт и возобновите работу ассистента. В репозитории также документирован Message Like Me — устаревший локальный CLI и Agent Skill для изучения истории личной переписки и создания черновиков в вашем стиле. Он превращает принадлежащую вызывающему историю в детерминированные локальные метрики, ограниченные пакеты доказательств, переиспользуемые профили стиля и неотправленные черновики, при этом CLI отвечает за прием, хранение, измерение и экспорт. Поддерживаемые источники включают Apple Messages chat.db, ZIP-архивы данных X, пакеты Beeper и WhatsApp, созданные Ghostget, и дополнительное обогащение метками macOS Contacts. Прием данных доступен только для чтения по отношению к источнику, использует стабильные приватные копии и никогда не аутентифицируется у провайдера сообщений и не отправляет сообщения. Семантическая интерпретация происходит только когда вы намеренно открываете артефакт в своей собственной среде агента; артефакт является границей между поверхностями CLI, Agent Skill и TypeScript-библиотеки. Профили сохраняют версию корпуса и дайджест пакета, из которых они произошли, поэтому устаревшие доказательства наглядно не проходят. Исходный код лицензирован MIT и также служит примером приложения для разработчиков, создающих на основе API генерации xcb. Веб-сайт носит информационный характер и не получает приватных сообщений или папок контактов.