CatchMe CLI
Локальная память об экране для агента: CatchMe хранит историю окон, клавиш и буфера обмена и отвечает на вопросы о ней.
- 521 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Постоянно записывает клавиши, буфер обмена и скриншоты, включая пароли и личные сообщения.
- Облачный провайдер сводок получает описания действий и скриншоты.
Установка
- Работает в
Ручная установка
git clone https://github.com/HKUDS/catchme.git && cd catchme
conda create -n catchme python=3.11 -y && conda activate catchme
pip install -e .Первый блок Install из README: клон, окружение conda с Python 3.11 и установка пакета.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Постоянно записывает клавиши, буфер обмена и скриншоты, включая пароли и личные сообщения.
- Облачный провайдер сводок получает описания действий и скриншоты.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
CatchMe — фоновая программа, которая записывает действия на компьютере: смену окон, клавиши, мышь, скриншоты, буфер обмена и уведомления. События складываются в дерево «день, сеанс, приложение, место, действие», а языковая модель пишет краткие сводки каждого уровня. Агент обращается к истории тремя способами: командой `catchme ask`, легким скиллом `CATCHME-light.md` или MCP-сервером `catchme mcp` с четырьмя инструментами. Сырые данные лежат локально в `~/data/`. Модель для сводок задают в `catchme init`: облачный провайдер вроде OpenRouter либо локальные Ollama, vLLM и LM Studio.
Для кого. Разработчикам и исследователям, которые просят агента вспомнить, что они делали за компьютером: какие файлы правили, что читали, что набирали.
Подходит, если
- Агент вспоминает, над чем вы работали вчера в Claude Code.
- К концу дня нужно восстановить список файлов, которые вы правили.
- Статью или поисковый запрос недельной давности ищут по истории окон.
- Итоги дня собирают из сводок по приложениям и сеансам.
Не подходит, если
- На экране открыты чужие пароли, переписки или документы, которые нельзя записывать.
- Облачную модель для сводок использовать нельзя, а локальной модели с поддержкой изображений нет.
- Работа идет на Linux, и важна запись клавиатуры: там она не реализована.
Пример запроса к агенту
Что я делал в Claude Code сегодня после обеда? Назови файлы, которые менял.Ограничения
Программа записывает нажатия клавиш, буфер обмена и скриншоты, поэтому в истории могут оказаться пароли и личные сообщения. При облачном провайдере материал для сводок уходит к нему, при локальной модели остается на машине. Модель должна понимать изображения, а расход токенов ограничивают параметром `llm.max_calls`. На macOS нужны разрешения Accessibility, Input Monitoring и Screen Recording, на Windows запуск от администратора, на Linux только X11. Требуется Python 3.11 или новее.
Как отключить. Остановите процесс `catchme awake`, удалите скилл из `~/.cursor/skills/catchme/` и секцию `catchme` из конфигурации MCP. Накопленные данные лежат в `~/data/`, их стирают отдельно.
Частые вопросы
Как подключить CatchMe к агенту?
Выберите скилл или MCP. Для скилла запустите `catchme awake` и скопируйте `CATCHME-light.md` в `~/.cursor/skills/catchme/SKILL.md`. Для MCP выполните `pip install 'catchme[mcp]'` и добавьте в конфигурацию клиента команду `catchme` с аргументом `mcp`.
Какие инструменты дает MCP-сервер?
Четыре: `search_activity` отвечает на вопросы по истории, `list_days` показывает записанные дни, `get_session` открывает сеанс, `get_tree` отдает дерево за дату. Процесс `catchme awake` должен работать.
Уходят ли данные в облако?
Сырые данные остаются в `~/data/`. Облачный провайдер получает материал для сводок, если вы его выбрали. С Ollama, vLLM или LM Studio программа работает офлайн.
Чем полный скилл отличается от легкого?
Легкий скилл только читает историю при запущенном `catchme awake`. `CATCHME-full.md` передает агенту весь жизненный цикл: он сам запускает и настраивает программу.
Какие системы поддерживаются?
macOS, Windows и Linux. На macOS нужны разрешения Accessibility, Input Monitoring и Screen Recording, на Windows запуск от администратора. На Linux только X11, а запись клавиатуры не реализована.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЛокальная запись экрана и звука с поиском на естественном языке, отдает историю действий агенту через MCP
Приложение для macOS помнит, что было на экране, и открывает агентам историю по MCP: поиск, дни, потоки работы, скриншоты.
Приложение в меню macOS пишет текст активных окон за день в markdown, а MCP-сервер отдает эту запись агенту
Minutes
minutes
Локальный MCP-сервер для памяти о встречах: запись и транскрипция на устройстве в Markdown, поиск истории из Claude Code, Codex, Cursor и других MCP-клиентов
Локальная веб-панель, где агент сам собирает виджеты и экраны поверх файлов, API и MCP-серверов проекта
Локальный MCP-сервер, с помощью которого агент задает вам вопрос в консоли, ждет ответа и присылает уведомление о конце работы
Коротко о README
В документации три стадии: запись событий, сборка дерева активности и поиск по нему без векторной базы. Модель идет по сводкам сверху вниз, выбирает ветки и открывает сырые данные вроде скриншотов. Отдельный раздел объясняет настройку провайдеров и параметры фильтров.